How it works
- Create your TextIt account
- Go to your TextIt account page and enter {your wordpress url}/textit-webhook-receiver as your WebHook URL
- Paste the generated API token in the Wordpress TextIt SDK settings page and save changes
- Go to Settings > Permalinks and save to refresh the Wordpress rewrite rules
- Now you can use the textit_webhook_event hook in your custom plugin or theme to respond to TextIt webhook events, and WordpressTextItSDK::textItDo() to call the TextIt REST API
TextIt API
Full documentation is available:
https://textit.in/api/v1
Quick method reference:
- contacts - To list or modify contacts.
- fields - To list or modify contact fields.
- messages - To list and create new SMS messages.
- relayers - To list, create and remove new Android phones.
- calls - To list incoming, outgoing and missed calls as reported by the Android phone.
- flows - To list active flows.
- runs - To list or start flow runs for contacts.
- campaigns - To list or modify campaigns on your account.
- events - To list or modify campaign events on your account.
- boundaries - To retrieve the geometries of the administrative boundaries on your account.
textItDo()
To call the TextIt API, use
WordpressTextItSDK::textItDo($method, $args, $http)
$method - string - One of the TextIt API methods listed above
$args - array - 2 dimensional array containing argument names and values. Details of accepted arguments in the TextIt documentation
$http - string - Either
GET or
POST, depending on whether you want to list or add / modify data
The return value will be either an array with a TextIt API response or an exception
E.g.
WordpressTextItSDK::textItDo( 'contacts', array(), 'GET' ) would return a list of contacts from your TextIt account
textit_webhook_event
To respond to TextIt webhook events (e.g. Incoming Messages, Outgoing Messages, Incoming Calls, Outgoing Calls, Relayer Alarms) use
add_action( 'textit_webhook_event', 'my_custom_function', 2, 1 )
Your custom function should accept a single argument -
$event - an array containing the data TextIt posted via the webhook