Opentact
  • Opentact Introduction
  • KEY CONCEPTS
    • Basic Concept
      • Voice Capability
        • Managing Inbound Calls
      • SMS Capability
      • Number Capability
    • Phone Number
      • Voice Enablement
      • SMS Enablement
      • TN Profile
        • Blacklist Caller ID
        • Whitelist Caller ID
    • SIP Control APP
      • Specify Remote Call Control URL
      • Specify Dialplan XML
    • SIP Trunking
    • Messaging
      • Quick Start Guide
      • Prepare Phone Numbers for SMS
    • SIP Connection
      • Associate SIP Connection with Phone Number
    • SIP Domain
      • Send Outbound Call with SIP Domain
      • Receive Inbound Call to SIP User
        • Web Call
        • Zoiper SIP Client
    • SIP Users
      • Create a SIPUser
      • Create a SIPUserInvite
    • Telecom Data
  • Opentact API Documentation
    • Opentact API Integration
      • API Environment
      • Opentact API keys
      • Passing Authentication
      • Authentication API
        • Example API Call
        • Authentiction with Gmail
    • TN Profile
      • Add and Remove Blacklist to TN Profile
        • Example API Call
      • Add and Remove Whitelist to TN Profile
        • Example API Call
    • Phone Number
      • Order Phone Number
        • Example API Usage
      • Release a Number
        • Example API Usage
      • Get all Purchased Numbers
      • Number Search
        • Example API Usage
    • SIP Connection
      • Remove Number from SIP Connection
      • Get Number for a SIP Connection
      • Update SIP Connections
      • Create SIP Conenctions
      • Delete SIP Connections
      • List SIP Connections
      • Assign Number to a SIP Connection
    • Messaging
      • Enable SMS on Numbers
      • Disable SMS on Number
      • Send SMS with Pool
      • Send SMS with Number
      • Receiving SMS
      • Retrieve Message Detail Records
      • Receiving Messaging Events
    • Log Retrieval
      • Retrieve Call Log
      • Retrieve SMS Log
    • Calling
      • Bridge two calls
      • Make Single Call
      • Make Bulk Call
        • Example API Call
    • SIP Domain
      • Create SIP Domain
      • Create SIP User
      • Deleting SIP User
      • Modify SIP User
    • Websocket Event Subscription
      • Create Subscription
      • Remove Subscription
      • Get Subscribed Events
        • Example API Call
  • Websocket Events
    • Event Websocket
    • Websocket Authentication
      • How to Authenticate to WSS
      • Authentication Response
      • Explanation of JSON response
    • Event Definition
      • Call Initiated
        • Example Event
      • Call Ringing
        • Example Event
      • Call Live
        • Example Event
      • Callflow
        • Example Event
      • Call Hangup
        • Example Event
      • Call Destroyed
        • Example Event
      • Call Bridged
        • Example Event
      • Call Answered
        • Example Event
      • Account events
        • Example Event
      • SMS events
        • Example Event
      • TN events
        • Example Event
      • Record Events
        • Example Event
      • Transcript
        • Example Event
      • General Event Fields
      • Example Event
  • Opentact XML
    • Overview
    • <Call/>
    • <Callback/>
    • <Geo/>
    • <Scheduler/>
    • <Play/>
    • <Say/>
    • <Hangup/>
    • <Pause/>
    • <Record/>
    • </Dial>
    • </Gather>
    • <Answer/>
    • <Hold/>
    • <Tone/>
    • <Error/>
    • <Default/>
    • <Meta/>
    • <Curl/>
  • How to build your Opentact Application
    • Introduction
    • Inbound Call Control
    • Opentact Events
    • Call Flow Control
      • Specify CallFlow for TN
        • Dynamic Call Flow XML
        • Basic Workflow
      • Handle Inbound Call
    • Send and Receive SMS
      • Life Cycle of SMS Delivery
      • Real-time SMS over Websocket
      • Send SMS via Restful API
    • Send and Receive SIP Calls
      • Create SIP User
      • Make Calls Between SIP User
      • Receive Calls as SIP User
  • Regulatory Compliance
    • 10DLC FAQs
    • Stir Shaken
  • SIP Trunking
    • Use Opentact for SIP Trunking
  • Webhook Event
    • Introduction
    • Test Webhook with Opentact
    • Event Definition
Powered by GitBook
On this page

Was this helpful?

  1. Opentact XML

<Geo/>

Introduction to <Geo/> Tag in Opentact XML

The <Geo/> tag in Opentact XML provides a powerful mechanism to filter incoming calls based on their Caller ID attributes, such as states or counties. This enables users to tailor call responses according to the geographical origin of the caller. Let's explore how the <Geo/> tag works with a few examples:

Basic Usage:

<Geo states="NJ">
    <Say text="Hello New Jersey"/>
</Geo>

In this example, if the Caller ID indicates a state of New Jersey, Opentact will execute the action specified within the <Geo> tag, responding with a greeting tailored to New Jersey callers.

Handling Multiple States:

<Geo states="AL,OK">
    <Say text="Hello Alaska or Outland"/>
</Geo>

This <Geo> tag accommodates callers from either Alaska or Oklahoma. The contained action will be executed for callers from these specified states.

Counties and States Combination:

<Geo states="NJ,CA" county="ESSEX">
    <Say text="Hello Essex County, New Jersey"/>
</Geo>

In this example, Opentact not only filters by states (New Jersey and California) but also refines the filter by including callers from Essex County, New Jersey. The response is tailored to this specific geographical criterion.

Unfiltered Execution:

<Geo>
    <!-- This block is executed without any specific filters -->
</Geo>

When no filters are specified within the <Geo> tag, the contained action is executed for all incoming calls, providing a default response or action.

Full Example:

<Response>
    <Say tag="greeting">Thanks for calling Opentact!</Say>

    <Geo states="NJ">
        <Say text="Hello New Jersey"/>
    </Geo>

    <Geo states="CA">
        <Say text="Hello California"/>
    </Geo>

    <Geo>
        <!-- This block would be executed for all calls -->
    </Geo>

    <Geo states="AL,OK">
        <Say text="Hello Alaska or Outland"/>
    </Geo>

    <Geo states="NJ,CA" county="ESSEX">
        <Say text="Hello Essex County, New Jersey"/>
    </Geo>
</Response>

This comprehensive example demonstrates various use cases of the <Geo/> tag within an Opentact XML response, showcasing the flexibility it provides for call customization based on geographical attributes.

Previous<Callback/>Next<Scheduler/>

Last updated 1 year ago

Was this helpful?