FAQ - ITCTXT Connect OpenAPI

Q. Do we need to create a ITCTXT app in Zapier?
A. No we don't need to. ITCTXT app is already available in Zapier.

Q. I am trying to add ITCTXT to Zapier, and I get a popup message but the window is blank. It never asks me to log in.
A. Sometimes Zapier may have cache issue. You can try in browser incognito mode.

Q. How to get the message details when we recieve an inbound message?
A. This is possible through a few steps.
1-Subscribe to ITCTXT webhooks for message
2-extract messageId from payload and call getmessagebyId API.

1-Client applications can subscribe for webhook notifications and listen for various events pertaining to their data in ITCTXT, including: inbound and outbound messages.

You can send below webhook request.

API End Point : https://connect.beetexting.com/itc-prod/webhooksubscription
Method: POST
Request Body:

First GetAccessToken by sending all OAuth2.0 parameters for your application and logging in to the application. After Getting Access Token use the same as Auth header. Then add the x-api-key header as request header. You can get both of these by following the OAuth 2.0 for ITCTXT section in this documentation.
In the request body use the below webhook request.
Replace 'organizationId' and 'departmentId' with your organizationId and departmentId. To get
notifications for 'inbound' messages use 'inbound' as value for direction. For 'outbound' use outbound likewise.

To know how to do that, please see the section Create or Update Subscription .

You can use a tool like postman to make above calls. To know more on that please see Postman How-to for ITCTXT OpenAPIs

The above webhook request will send a response as below :

Response Body:

Once an Inbound message comes we will send the following payload to the above mentioned callback url. See below the sample payload for the inbound message :

2-Using the messageId from the above payload, you can call the below end point to get the message details.

API End Point : https://connect.beetexting.com/itc-prod/message/getmessagebyid/{messageId}
Method : GET

**Response: **

Sample Response :

Q. How to get a notification whenever a contact is added to ITCTXT ?
A. This is possible through ITCTXT webhooks. Client applications can subscribe for webhook notifications and listen for various events pertaining to their data in ITCTXT, including: create, update or delete contacts.

You can send below webhook request.

To know how to do that, please see the section Create or Update Subscription .

You can use a tool like postman to make above calls. To know more on that please see Postman How-to for ITCTXT OpenAPIs