- Prerequisite
- Authentication using Tokens.
- Introduction of API's
- Create a New User/Agent
- Update User/Agent
- Delete User/Agent
- Fetch List of User/Agent (with filter)
- User/Agent Active/Inactive
- Fetch User/Agent Details
- Resent Verification Link
- Reset Password
- Purchase Number
- Fetch Country List
- Fetch List of Available No.
- Fetch List of Number
- Update ASR Configration
- Update TTS Configration
- Attach DVA
- De-Attach DVA
- Assign Team
- Unassign Team
- Create SIP Trunk
- Update SIP Trunk
- Delete SIP Trunk
- Test SIP Trunk
- List SIP Trunk
- Update ASR Configration
- Update TTS Configration
- Attach DVA
- De-Attach DVA
- Assign Team
- Unassign Team
- Create SMS Gateway
- Update SMS Gateway
- Delete SMS Gateway
- List SMS Gateway
- Send SMS
- List Sent SMS
- Create FHIR
- Delete FHIR
- List FHIR
- CSV Uploads
- Fetch Call-ai DVA Template
- Create DVA
- List Your DVA
- Attach Number
- De-Attach Number
- Get Details of DVA
- Update DVA
- Delete DVA
- Make a Voice Call
- Schedule Voice Call
- Create Campaign
- Update Campaign
- Update Scheduler
- Update Dialer
- Call Status For a Number
- DialOut time for a Number
- Fetch List Campaign
- Fetch Single Campaign
- Delete Campaign
- Fetch List Dialer Base
- upload Contact in DialerBase By phonebook Id
- upload Individual Contact in DialerBase
- Upload Contacts in DialerBase through xlsx file For Outreach
- Create Campaign
- Update Campaign
- Update Scheduler
- Update Dialer
- Call Status For a Number
- DialOut time for a Number
- Fetch List Campaign
- Fetch Single Campaign
- Delete Campaign
- Fetch List Dialer Base
- upload Contact in DialerBase By phonebook Id
- upload Individual Contact in DialerBase
- Upload Contacts in DialerBase through xlsx file For Outreach
- Create Phonebook
- List Phonebook
- Fetch Phonebook
- Fetch Phonebook by ID
- Update Phonebook
- Delete Phonebook
- Create Contact
- List Contact
- Fetch Contact
- Fetch Contact by ID
- Update Contact
- Upload Contact Xlsx File
- Delete Contact
- API Reference
- Message Privacy
- Fetch CDR
- Fetch Agent Call Detail
- Fetch Queue|Team Detail
- Fetch Call Recording
- Fetch Call Transcript
- Delete Call Recording
- Delete Call Transcript
- Fetch Total Call Duration In/Out
Overview
Streamline Your Telephony Integration with Call-AI Integration API's
In today's fast-paced world, seamless communication is the key to success for businesses across industries. With the ever-increasing demand for efficient telephony systems, integrating your existing telephony gateway with cutting-edge technologies becomes imperative. That's where the Call-AI Integration API's come into play, offering you a game-changing solution to enhance your communication infrastructure.
What is Call-AI Integration API's?
The Call-AI Integration API's are a set of powerful tools that empower you to integrate your current telephony gateway, whether it's Cisco, Avaya, Genesys, or any other, with the advanced Call-AI VoiP gateway. This integration enables you to unlock a world of possibilities and take your telephony capabilities to a whole new level.
Seamless Integration Process
The integration process is designed to be hassle-free, allowing businesses of all sizes to effortlessly combine their existing telephony infrastructure with Call-AI VoiP gateway. With simple and intuitive steps, you can seamlessly configure SIP trunks to efficiently route both incoming and outgoing traffic. This ensures that your communications are never compromised, and your clients can always reach you without a glitch.
Configuring VoiP Numbers and Virtual Agents
Call-AI Integration API's open the door to greater flexibility when it comes to handling VoiP numbers and virtual agents. Now, you can easily configure VoiP numbers and attach them to your virtual agents, granting them the ability to handle incoming calls professionally and efficiently. This means no more missed calls or dissatisfied customers, as your virtual agents will be equipped to handle any influx of communication with ease.
Enhancing Communication with ASR and TTS Features
A truly remarkable aspect of the Call-AI Integration API's is the effortless setup of Automatic Speech Recognition (ASR) and Text-to-Speech (TTS) features. These cutting-edge functionalities enable your telephony system to understand and process spoken language while also converting written text into natural-sounding speech. This advancement ensures that your communication becomes more engaging, interactive, and personalized.
Create SIP Trunk
The save SIP trunk API facilitates user to save/create SIP Trunks for a specific number.
Endpoint URL
https://api.call-ai.com/basic-integrations/v1/basic/api/v1/number/voip
Request Variables (Header Params)
You can retrieve the access token by entering the below-mentioned values in the Request Variables:
Variable | Description | Data Type |
---|---|---|
Ocp-Apim-Subscription-Key | Subscription Key of Tenant | String |
Authorization | Jwt token | String |
Request Variables (Body Params)
It takes a JSON request body with the following notable parameter:
Variable | Description | Data Type | Example value |
---|---|---|---|
type | Type define the entity individual personality. | String | VOIP |
msisdn | MSISDN refers to the unique identifiers used in telecommunication networks to represent mobile phone numbers. | String | 19212093845 |
cost | Cost refers to the amount of money or resources required to acquire/buy a number. | String | 0.9 |
tenant_id | A tenant ID is a unique identifier utilized to associate the data of each tenant with their specific account or instance. | String | tenant_12345 |
features | Features refers to specific qualities, characteristics or attributes of a number. | String | VOICE |
voip_user_id | VOIP user ID refers to a unique identifier assigned to an individual user within a Voice over IP (VoIP) system. | String | 9897969594 |
voip_user_password | VOIP user password refers to the confidential string of characters or passphrase set by a user to authenticate their identity and gain access to Voice over IP (VoIP) services. | String | Abc123 |
voip_sip_server | The SIP server being used for the VOIP call | String | test-server |
customer_email | Customer email refers to the email address associated with a customer's account or profile. | String | customer123@gmail.com |
country | A country is a distinct and sovereign geographical and political entity that is typically characterized by a defined territory, a stable government, and a recognized international status. | String | US |
Sample Request
POST https://api.call-ai.com/basic-integrations/v1/basic/api/v1/number/voip Content-Type: application/json Cache-Control: no-cache Authorization: Bearer •••••••••••••••• Ocp-Apim-Subscription-Key: •••••••••••••••• { "type": "VOIP", "msisdn": "19212093845", "cost": "0.9", "tenant_id": "tenant_12345", "features": ["VOICE"], "voip_user_id": "9897969594", "voip_user_password": "Abc123", "voip_sip_server": "test-server", "customer_email": "customer123@gmail.com", "country": "US" }
Response Variables
Variable | Description | Data Type |
---|---|---|
Response | Response defines the expected behavior and structure of the responses that clients can receive when interacting with the API. | String |
Message | Message represents the content that is being transmitted from the server to the client. | String |
Data | Data represents the information or content that the API provides to the client or consumer. | object |
error | Error defines the expected behavior and structure of the error responses that clients can receive when interacting with the API. | object |
Response Schema
A successful request returns the HTTP 200 OK status code and a JSON response body as detailed below:
Update SIP Trunk
The update SIP trunk API enables users to modify existing SIP Trunk information by providing updated data.
Endpoint URL
https://api.call-ai.com/basic-integrations/v1/basic/api/v1/number/update-voip-number
Request Variables (Header Params)
You can retrieve the access token by entering the below-mentioned values in the Request Variables:
Variable | Description | Data Type |
---|---|---|
Ocp-Apim-Subscription-Key | Subscription Key of Tenant | String |
Authorization | Jwt token | String |
Request Variables (Body Params)
It takes a JSON request body with the following notable parameter:
Variable | Description | Data Type | Example value |
---|---|---|---|
msisdn | MSISDN refers to the unique identifiers used in telecommunication networks to represent mobile phone numbers. | String | 19212093845 |
tenant_id | A tenant ID is a unique identifier utilized to associate the data of each tenant with their specific account or instance. | String | tenant_12345 |
voip_user_id | VOIP user ID refers to a unique identifier assigned to an individual user within a Voice over IP (VoIP) system. | String | 9897969594 |
voip_user_password | VOIP user password refers to the confidential string of characters or passphrase set by a user to authenticate their identity and gain access to Voice over IP (VoIP) services. | String | Abc123 |
voip_sip_server | The SIP server used for the VOIP service. | String | test-server |
customer_email | Customer email refers to the email address associated with a customer's account or profile. | String | customer123@gmail.com |
old_msisdn | Old MSISDN refers to the previously assigned MSISDN of a mobile device or phone number. | String | 19212093845 |
is_numberChanged | A boolean flag indicating whether the phone number associated with the VOIP service has changed. | boolean | true |
Sample Request
PATCH https://api.call-ai.com/basic-integrations/v1/basic/api/v1/number/update-voip-number Content-Type: application/json Cache-Control: no-cache Authorization: Bearer •••••••••••••••• Ocp-Apim-Subscription-Key: •••••••••••••••• { "msisdn": "19212093845", "tenant_id": "tenant_12345", "voip_user_id": "9897969594", "voip_user_password": "Abc123", "voip_sip_server": "test-server", "customer_email": "customer123@gmail.com", "old_msisdn": "19212093845", "is_numberChanged": "true" }
Response Variables
Variable | Description | Data Type |
---|---|---|
Response | Response defines the expected behavior and structure of the responses that clients can receive when interacting with the API. | String |
Message | Message represents the content that is being transmitted from the server to the client. | String |
Data | Data represents the information or content that the API provides to the client or consumer. | object |
error | Error defines the expected behavior and structure of the error responses that clients can receive when interacting with the API. | object |
Response Schema
A successful request returns the HTTP 200 OK status code and a JSON response body as detailed below:
Delete SIP Trunk
The delete SIP trunk API facilitates user to delete a SIP Trunk from your account.
Endpoint URL
https://api.call-ai.com/basic-integrations/v1/basic/api/v1/number/delete-voip-number
Request Variables (Header Params)
You can retrieve the access token by entering the below-mentioned values in the Request Variables:
Variable | Description | Data Type |
---|---|---|
Ocp-Apim-Subscription-Key | Subscription Key of Tenant | String |
Authorization | Jwt token | String |
Request Variables (Body Params)
It takes a JSON request body with the following notable parameter:
Variable | Description | Data Type | Example value |
---|---|---|---|
msisdn | MSISDN refers to the unique identifiers used in telecommunication networks to represent mobile phone numbers. | String | 19212093845 |
customer_email | Customer email refers to the email address associated with a customer's account or profile. | String | customer123@gmail.com |
tenant_id | A tenant ID is a unique identifier utilized to associate the data of each tenant with their specific account or instance. | String | tenant_12345 |
bot_attached.bot_id | The unique identifier of the bot. | String | sadfsdf3dsf43v34nfn |
Sample Request
DELETE https://api.call-ai.com/basic-integrations/v1/basic/api/v1/number/delete-voip-number Content-Type: application/json Cache-Control: no-cache Authorization: Bearer •••••••••••••••• Ocp-Apim-Subscription-Key: •••••••••••••••• { "msisdn": "19212093845", "customer_email": "customer123@gmail.com", "tenant_id": "tenant_12345", "bot_attached": { "bot_id": "sadfsdf3dsf43v34nfn" } }
Response Variables
Variable | Description | Data Type |
---|---|---|
Response | Response defines the expected behavior and structure of the responses that clients can receive when interacting with the API. | string |
Message | Message represents the content that is being transmitted from the server to the client. | String |
Data | Data represents the information or content that the API provides to the client or consumer. | object |
error | Error defines the expected behavior and structure of the error responses that clients can receive when interacting with the API. | object |
Response Schema
A successful request returns the HTTP 200 OK status code and a JSON response body as detailed below:
Test SIP Trunk
The test SIP trunk API facilitates users to test a SIP Trunks for a given MSISDN number and will check the SIP Trunk connection to return a success or failure message
Endpoint URL
https://api.call-ai.com/basic-integrations/v1/basic/api/v1/number/test-voip/{msisdn}
Request Variables (Header Params)
You can retrieve the access token by entering the below-mentioned values in the Request Variables:
Variable | Description | Data Type |
---|---|---|
Ocp-Apim-Subscription-Key | Subscription Key of Tenant | String |
Authorization | Jwt token | String |
Request Variables (Path Params)
It takes a JSON request body with the following notable parameter:
Variable | Description | Data Type | Example value |
---|---|---|---|
msisdn | MSISDN refers to the unique identifiers used in telecommunication networks to represent mobile phone numbers. | String | 19212093845 |
Sample Request
POST https://api.call-ai.com/basic-integrations/v1/basic/api/v1/number/test-voip/{msisdn} Cache-Control: no-cache Authorization: Bearer •••••••••••••••• Ocp-Apim-Subscription-Key: ••••••••••••••••
Response Variables
Variable | Description | Data Type |
---|---|---|
Response | Response defines the expected behavior and structure of the responses that clients can receive when interacting with the API. | string |
Message | Message represents the content that is being transmitted from the server to the client. | String |
data.message | Message represents the content that is being transmitted from the server to the client. | string |
data.connection_result | string | |
error | Error defines the expected behavior and structure of the error responses that clients can receive when interacting with the API. | object |
Response Schema
A successful request returns the HTTP 200 OK status code and a JSON response body as detailed below:
List SIP Trunk
The list all SIP trunks API facilitates user to retrieve a comprehensive list of SIP Trunks belonging to the specified tenant.
Endpoint URL
https://api.call-ai.com/basic-integrations/v1/basic/api/v1/number/voip-numbers/{tenant_id}
Request Variables (Header Params)
You can retrieve the access token by entering the below-mentioned values in the Request Variables:
Variable | Description | Data Type |
---|---|---|
Ocp-Apim-Subscription-Key | Subscription Key of Tenant | String |
Authorization | Jwt token | String |
Request Variables (Path Params)
It takes a JSON request body with the following notable parameter:
Variable | Description | Data Type | Example value |
---|---|---|---|
tenant_id | A tenant ID is a unique identifier utilized to associate the data of each tenant with their specific account or instance. | String | tenant_12345 |
Sample Request
GET https://api.call-ai.com/basic-integrations/v1/basic/api/v1/number/voip-numbers/{tenant_id} Cache-Control: no-cache Authorization: Bearer •••••••••••••••• Ocp-Apim-Subscription-Key: ••••••••••••••••
Response Variables
Variable | Description | Data Type |
---|---|---|
Response | Response defines the expected behavior and structure of the responses that clients can receive when interacting with the API. | string |
Message | Message represents the content that is being transmitted from the server to the client. | String |
data.purchased_numbers_db[]._id | A unique and distinctive label or code is assigned to an entity or individual within a particular context or system, serving the purpose of differentiation from others. | string |
data.purchased_numbers_db[].country | A country is a distinct and sovereign geographical and political entity that is typically characterized by a defined territory, a stable government, and a recognized international status. | string |
data.purchased_numbers_db[].msisdn | MSISDN refers to the unique identifiers used in telecommunication networks to represent mobile phone numbers. | string |
data.purchased_numbers_db[].customer_email | Customer email refers to the email address associated with a customer's account or profile. | string |
data.purchased_numbers_db[].tenant_id | A tenant ID is a unique identifier utilized to associate the data of each tenant with their specific account or instance. | string |
data.purchased_numbers_db[].voip_user_id | VOIP user ID refers to a unique identifier assigned to an individual user within a Voice over IP (VoIP) system. | string |
data.purchased_numbers_db[].voip_user_password | VOIP user password refers to the confidential string of characters or passphrase set by a user to authenticate their identity and gain access to Voice over IP (VoIP) services. | string |
data.purchased_numbers_db[].voip_sip_server | The SIP server being used for the VOIP call | string |
data.purchased_numbers_db[].created_at | The specific date the entity is created. | string |
data.purchased_numbers_db[].updated_at | The specific date the entity is updated. | string |
data.purchased_numbers_db[].is_active | The key indicates whether the entity is active or not. | boolean |
error | Error defines the expected behavior and structure of the error responses that clients can receive when interacting with the API. | object |
Response Schema
A successful request returns the HTTP 200 OK status code and a JSON response body as detailed below:
Update ASR Configration
The "Update ASR Data" refers to an operation or API that allows you to modify or update the data used for Automatic Speech Recognition (ASR) systems. ASR technology is designed to convert spoken language into written text, and updating the ASR data involves making changes to the underlying language models, acoustic models, or other components used in the ASR system.
Endpoint URL
https://api.call-ai.com/basic-numbers/v1/basic/api/v1/number/googleASR/save
Request Variables (Header Params)
You can retrieve the access token by entering the below-mentioned values in the Request Variables:
Variable | Description | Data Type |
---|---|---|
Ocp-Apim-Subscription-Key | Subscription Key of Tenant | String |
Authorization | Jwt token | String |
Request Variables (Body Param)
It takes a JSON request body with the following notable parameter:
Variable | Description | Data Type | Example value |
---|---|---|---|
asr.asr_engine | The name of the ASR engine used to process the speech data. | string | |
asr.number | The phone number associated with the speech data. | string | 1234567 |
asr.language_code | The language code used in the speech data. | string | en-US |
asr.model | The model used by the ASR engine to process the speech data. | string | English-US |
asr.tenant_id | A tenant ID is used to associate each tenant's data with their specific account or instance. | string | Tenant_12345 |
asr.language | The language used in the speech data. | string | Hindi(India) |
asr.displayed_model | The displayed name of the model used by the AS enginen to process the speech data. | string | Default |
mode | Mode represents whether the data being sent i.e. is a new record to be created or existing record to be updated. | string | Update |
Sample Request
Use the below-mentioned method to update a asr data:
POST https://api.call-ai.com/basic-integrations/v1/basic/api/v1/number/googleASR/save Content-Type: application/json Cache-Control: no-cache Authorization: Bearer •••••••••••••••• Ocp-Apim-Subscription-Key: •••••••••••••••• { "asr": { "asr_engine": "google", "number": "1234567890", "language_code": "en-US", "model": "English-US", "tenant_id": "tenant_12345", "language": "Hindi (India)", "displayed_model": "Default" }, "mode": "update" }
Response Variables
Variable | Description | Data Type |
---|---|---|
Response | SUCCESS or Error Code | string |
Message | Call message on success or error | string |
data | If API send back some data it will goes here. | object |
error | Contains information related to any error thrown by Call-Ai System. | object |
Response Schema
A successful request returns the HTTP 200 OK status code and a JSON response body as detailed below:
Update TTS Configration
The "Update TTS (Text-to-Speech) Data" feature refers to the capability of modifying or updating the data used by a Text-to-Speech system. TTS technology converts written text into spoken words, allowing computer systems to generate human-like speech.
Endpoint URL
https://api.call-ai.com/basic-numbers/v1/basic/api/v1/number/tts/save
Request Variables (Header Params)
You can retrieve the access token by entering the below-mentioned values in the Request Variables:
Variable | Description | Data Type |
---|---|---|
Ocp-Apim-Subscription-Key | Subscription Key of Tenant | String |
Authorization | Jwt token | String |
Request Variables (Body Param)
It takes a JSON request body with the following notable parameter:
Variable | Description | Data Type | Example value |
---|---|---|---|
tts.tts_engine | The name of the TTS engine used to process the speech data. | string | |
Tts.number | The phone number associated with the speech data. | string | 1234567 |
tts.language_code | the language code used in the speech data. | string | en-US |
tts.ssml_gender | SSML gender indicates the gender of the speaker of the TTS engine. | string | MALE |
Tts.voice | Voice defines the type of speech voice for the tts engine | string | “en-US-Standard-J" |
voice_style | Voice style refers to the specific manner, character, or tone in which speech or synthesized voices are delivered. | string | “Newscast-Formal” |
Tts.tenant_id | A tenant ID is used to associate each tenant's data with their specific account or instance. | string | “Tenant_12345” |
tt.pitch | Pitch represents the pitch for the TTS engine | string | 1 |
Tts.speed | Speed represents the speed for the TTS engine | string | 1 |
Tts.language | Language represents the language for the tts engine | string | Hindi (India) |
mode | Mode represents whether the data is being created or updated. | string | update |
Sample Request
Use the below-mentioned method to update a asr data:
POST https://api.call-ai.com/basic-integrations/v1/basic/api/v1/number/tts/save Content-Type: application/json Cache-Control: no-cache Authorization: Bearer •••••••••••••••• Ocp-Apim-Subscription-Key: •••••••••••••••• { "tts": { "tts_engine": "google", "number": "1234567890", "language_code": "en-US", "ssml_gender": "MALE", "voice": " en-US-Standard-J", "voice_style ": "Newscast-Formal", "tenant_id": "tenant_12345", "pitch": "1", "speed": "1", "language": "Hindi (India)" }, "mode": "update" }
Response Variables
Variable | Description | Data Type |
---|---|---|
Response | SUCCESS or Error Code | string |
Message | Call message on success or error | string |
data | If API send back some data it will goes here. | object |
error | Contains information related to any error thrown by Call-Ai System. | object |
Response Schema
A successful request returns the HTTP 200 OK status code and a JSON response body as detailed below:
Attach A Number With DVA
The api allows you to attach a phone number to a virtual agent. Once the number is attached, the virtual agent can receive and respond to messages sent to that number.
Endpoint URL
https://api.call-ai.com/basic-numbers/v1/basic/api/v1/number/attach/numberBot
Request Variables (Header Params)
You can retrieve the access token by entering the below-mentioned values in the Request Variables:
Variable | Description | Data Type |
---|---|---|
Ocp-Apim-Subscription-Key | Subscription Key of Tenant | String |
Authorization | Jwt token | String |
Request Variables (Body Param)
It takes a JSON request body with the following notable parameter:
Variable | Description | Data Type | Example value |
---|---|---|---|
number | The phone number associated with the bot | string | 12345678 |
tenant_id | A tenant ID is used to associate each tenant's data with their specific account or instance. | string | tenant_12345 |
bot_id | The unique identifier of the bot. | string | tefsdhfb2324xcnvx34534vdnj |
webhook | The URL of the webhook associated with the bot | string | "http://39.228.104.43:8896/webhooks/rest/webhook" |
Bot.bot_name | The name of the bot | string | abcd |
Bot.bot_id | The unique identifier of the bot | string | fsdjsdbfdndwjnejnwej34j3ruj |
Sample Request
Use the below-mentioned method to update a asr data:
POST https://api.call-ai.com/basic-integrations/v1/basic/api/v1/number/attach/numberBot Content-Type: application/json Cache-Control: no-cache Authorization: Bearer •••••••••••••••• Ocp-Apim-Subscription-Key: •••••••••••••••• { "number": "1234567890", "tenant_id": "tenant_12345", "webhook": "http://39.228.104.43:8896/webhooks/rest/webhook", "bot_name": "abcd", "bot_id": "fsdhfb2324xcnvx34534vdnj" }
Response Variables
Variable | Description | Data Type |
---|---|---|
Response | SUCCESS or Error Code | string |
Message | Call message on success or error | string |
data | If API send back some data it will goes here. | object |
error | Contains information related to any error thrown by Call-Ai System. | object |
Response Schema
A successful request returns the HTTP 200 OK status code and a JSON response body as detailed below:
Deattach A Number With DVA
The api allows you to deattach a phone number to a virtual agent. Once the number is deattached, the virtual agent will no longer receive and respond to messages sent to that number.
Endpoint URL
https://api.call-ai.com/basic-numbers/v1/basic/api/v1/number/deattach/numberBot
Request Variables (Header Params)
You can retrieve the access token by entering the below-mentioned values in the Request Variables:
Variable | Description | Data Type |
---|---|---|
Ocp-Apim-Subscription-Key | Subscription Key of Tenant | String |
Authorization | Jwt token | String |
Request Variables (Body Param)
It takes a JSON request body with the following notable parameter:
Variable | Description | Data Type | Example value |
---|---|---|---|
number | The phone number associated with the bot | string | 12345678 |
tenant_id | A tenant ID is used to associate each tenant's data with their specific account or instance.string | string | tenant_12345 |
bot_id | The unique identifier of the bot | string | tefsdhfb2324xcnvx34534vdnj |
Sample Request
Use the below-mentioned method to update a asr data:
POST https://api.call-ai.com/basic-integrations/v1/basic/api/v1/number/deattach/numberBot Content-Type: application/json Cache-Control: no-cache Authorization: Bearer •••••••••••••••• Ocp-Apim-Subscription-Key: •••••••••••••••• { "number": "1234567890", "tenant_id": "tenant_12345", "bot_id": "sadfsdf3dsf43v34nfn" }
Response Variables
Variable | Description | Data Type |
---|---|---|
Response | SUCCESS or Error Code | string |
Message | Call message on success or error | string |
data | If API send back some data it will goes here. | object |
error | Contains information related to any error thrown by Call-Ai System. | object |
Response Schema
A successful request returns the HTTP 200 OK status code and a JSON response body as detailed below:
Assign Team
Endpoint URL
https://api.call-ai.com/basic-numbers/v1/basic/api/v1/teams/save
Request Variables (Header Params)
You can retrieve the access token by entering the below-mentioned values in the Request Variables:
Variable | Description | Data Type |
---|---|---|
Ocp-Apim-Subscription-Key | Subscription Key of Tenant | String |
Authorization | Jwt token | String |
Request Variables (Body Param)
It takes a JSON request body with the following notable parameter:
Variable | Description | Data Type | Example value |
---|---|---|---|
number_attached | The phone number attached with the team. | string | 12345678 |
tenant_id | A tenant ID is used to associate each tenant's data with their specific account or instance. | string | tenant_12345 |
default_team | Default team defines whether the team default (true/false) | boolean | true |
display_name | The display name of the team. | testing | |
name | The name of the team. | string | abcd |
Sample Request
Use the below-mentioned method to update a asr data:
POST https://api.call-ai.com/basic-integrations/v1/basic/api/v1/teams/save Content-Type: application/json Cache-Control: no-cache Authorization: Bearer •••••••••••••••• Ocp-Apim-Subscription-Key: •••••••••••••••• { "tenant_id": "tenant_12345", "name": "tester_09722811", "display_name": "tester", "number_attached": "9876543210" }
Response Variables
Variable | Description | Data Type |
---|---|---|
Response | SUCCESS or Error Code | string |
Message | Call message on success or error | string |
data.response.created_at | Created at defines the date the team got created. | string |
data.response.team_id | The team id defines the unique id for the teams. | string |
data.response.tenant_id | A tenant ID is a unique identifier utilized to associate the data of each tenant with their specific account or instance. | string |
data.response.display_name | The display name for the teams. | string |
Data.response.name | The name for the teams. | string |
Data.response.number_attached | The number attached to the teams. | string |
Data.response.default_team | Default teams defines whether the team is default(true/false) | boolean |
error | Contains information related to any error thrown by Call-Ai System. | object |
Response Schema
A successful request returns the HTTP 200 OK status code and a JSON response body as detailed below:
Unassign Team
Endpoint URL
https://api.call-ai.com/basic-numbers/v1/basic/api/v1/teams
Request Variables (Header Params)
You can retrieve the access token by entering the below-mentioned values in the Request Variables:
Variable | Description | Data Type |
---|---|---|
Ocp-Apim-Subscription-Key | Subscription Key of Tenant | String |
Authorization | Jwt token | String |
Request Variables (Body Param)
It takes a JSON request body with the following notable parameter:
Variable | Description | Data Type | Example value |
---|---|---|---|
name | The name of the team. | string | Tester_0972811 |
Sample Request
Use the below-mentioned method to update a asr data:
DELETE https://api.call-ai.com/basic-integrations/v1/basic/api/v1/teams Content-Type: application/json Cache-Control: no-cache Authorization: Bearer •••••••••••••••• Ocp-Apim-Subscription-Key: •••••••••••••••• { "name": "tester_09722811" }
Response Variables
Variable | Description | Data Type |
---|---|---|
Response | SUCCESS or Error Code | string |
Message | Call message on success or error | string |
data | If API send back some data it will goes here. | object |
error | Contains information related to any error thrown by Call-Ai System. | object |
Response Schema
A successful request returns the HTTP 200 OK status code and a JSON response body as detailed below:
Create SMS Gateway
The save configuration details API enables users to store the specific configuration details for an SMS connector. This functionality allows for the convenient preservation and retrieval of the configured settings related to the SMS connector, ensuring consistency and ease of use.
Endpoint URL
https://api.call-ai.com/basic-integrations/v1/basic/api/v1/sms_integration
Request Variables (Header Params)
You can retrieve the access token by entering the below-mentioned values in the Request Variables:
Variable | Description | Data Type |
---|---|---|
Ocp-Apim-Subscription-Key | Subscription Key of Tenant | String |
Authorization | Jwt token | String |
Request Variables (Body Params)
It takes a JSON request body with the following notable parameter:
Variable | Description | Data Type | Example value |
---|---|---|---|
type | Type define the entity individual personality. | String | sms |
tenant_id | A tenant ID is a unique identifier utilized to associate the data of each tenant with their specific account or instance. | String | tenant_12345 |
number | A number is a numerical sequence assigned to a telephone line or device to establish communication with other parties. | String | 1234567890 |
id | It is a unique and specific label or code assigned to an entity, or individual to distinguish it from others within a given context or system. | String | 1234 |
secret | The secret key used to authenticate with the SMS provider. | String | fejv43rdvnt43r3ff |
is_activated | The key indicates whether the entity is active or not. | boolean | true |
Sample Request
POST https://api.call-ai.com/basic-integrations/v1/basic/api/v1/sms_integration Content-Type: application/json Cache-Control: no-cache Authorization: Bearer •••••••••••••••• Ocp-Apim-Subscription-Key: •••••••••••••••• { "type": "sms", "tenant_id": "tenant_12345", "number": "1234567890", "id": "1234", "secret": "fejv43rdvnt43r3ff", "is_activated": true }
Response Variables
Variable | Description | Data Type |
---|---|---|
Response | Response defines the expected behavior and structure of the responses that clients can receive when interacting with the API. | string |
Message | Message represents the content that is being transmitted from the server to the client. | String |
data.result.acknowledged | The key indicates whether the entity is acknowledged or not. | boolean |
data.result.modifiedCount | Modified count refers to the number of documents or records that were successfully updated or modified | integer |
data.result.upsertedId | Upserted ID refers to the unique identifier of a document or record that was inserted or updated during an upsert operation. | String |
data.result.upsertedCount | Upserted count indicates the total number of documents or records that were inserted or updated during an upsert operation. | integer |
data.result.matchedCount | Matched count refers to the number of documents or records that matched the specified criteria. | integer |
error | Error defines the expected behavior and structure of the error responses that clients can receive when interacting with the API. | object |
Response Schema
A successful request returns the HTTP 200 OK status code and a JSON response body as detailed below:
Update SMS Gateway
The Integration API is a web-based interface that enables to search for available DID(Direct Inward Dialing) numbers and purchase them configure voice over internet protocol (VOIP) with call AI, and attach and detach numbers with virtual agents. The service also includes functionality for setting up automatic speech recognition (ASR) and text-to-speech (TTS) features for the numbers.Users can create and manage virtual agents through the service and virtual agent can also be updated at any time to keep up with changing business needs.Additionally, the service offers SMS connector configuration with popular providers like Twilio or Vonage, enabling users to manage SMS interactions with customers from within the microservice
Endpoint URL
https://api.call-ai.com/basic-integrations/v1/basic/api/v1/sms_integration
Request Variables (Header Params)
You can retrieve the access token by entering the below-mentioned values in the Request Variables:
Variable | Description | Data Type |
---|---|---|
Ocp-Apim-Subscription-Key | Subscription Key of Tenant | String |
Authorization | Jwt token | String |
Request Variables (Body Params)
It takes a JSON request body with the following notable parameter:
Variable | Description | Data Type | Example value |
---|---|---|---|
type | Type define the entity individual personality | String | sms |
tenant_id | A tenant ID is a unique identifier utilized to associate the data of each tenant with their specific account or instance. | String | tenant_12345 |
number | A number is a numerical sequence assigned to a telephone line or device to establish communication with other parties. | String | 1234567890 |
id | It is a unique and specific label or code assigned to an entity, or individual to distinguish it from others within a given context or system. | String | 1234 |
secret | The secret key used to authenticate with the SMS provider. | String | fejv43rdvnt43r3ff |
is_activated | The key indicates whether the entity is active or not. | boolean | true |
_id | A unique and distinctive label or code is assigned to an entity or individual within a particular context or system, serving the purpose of differentiation from others. | String | 62d5164908eb6c8c036f591h |
Sample Request
PATCH https://api.call-ai.com/basic-integrations/v1/basic/api/v1/sms_integration Content-Type: application/json Cache-Control: no-cache Authorization: Bearer •••••••••••••••• Ocp-Apim-Subscription-Key: •••••••••••••••• { "type": "sms", "tenant_id": "tenant_12345", "number": "1234567890", "id": "1234", "secret": "fejv43rdvnt43r3ff", "is_activated": true, "_id": "62d5164908eb6c8c036f591h" }
Response Variables
Variable | Description | Data Type |
---|---|---|
Response | Response defines the expected behavior and structure of the responses that clients can receive when interacting with the API. | string |
Message | Message represents the content that is being transmitted from the server to the client. | String |
data.result.acknowledged | The key indicates whether the entity is acknowledged or not. | boolean |
data.result.modifiedCount | Modified count refers to the number of documents or records that were successfully updated or modified | integer |
data.result.upsertedId | Upserted ID refers to the unique identifier of a document or record that was inserted or updated during an upsert operation. | String |
data.result.upsertedCount | Upserted count indicates the total number of documents or records that were inserted or updated during an upsert operation. | integer |
data.result.matchedCount | Matched count refers to the number of documents or records that matched the specified criteria. | integer |
error | Contains information related to any error thrown by Call-Ai System. | object |
Response Schema
A successful request returns the HTTP 200 OK status code and a JSON response body as detailed below:
Delete SMS Gateway
The delete SMS connector list API removes an SMS connector associated with a specific tenant based on its type and number. This API provides the functionality to delete the SMS connector from the list, ensuring efficient management of SMS connectors for the designated tenant.
Endpoint URL
https://api.call-ai.com/basic-integrations/v1/basic/api/v1/sms_integration/{tenant_id}/{type}/{number}
Request Variables (Header Params)
You can retrieve the access token by entering the below-mentioned values in the Request Variables:
Variable | Description | Data Type |
---|---|---|
Ocp-Apim-Subscription-Key | Subscription Key of Tenant | String |
Authorization | Jwt token | String |
Request Variables (Path Params)
It takes a JSON request body with the following notable parameter:
Variable | Description | Data Type | Example value |
---|---|---|---|
tenant_id | A tenant ID is a unique identifier utilized to associate the data of each tenant with their specific account or instance. | String | tenant_12345 |
type | Type define the entity individual personality. | String | sms |
number | A number is a numerical sequence assigned to a telephone line or device to establish communication with other parties. | String | 1234567890 |
Sample Request
DELETE https://api.call-ai.com/basic-integrations/v1/basic/api/v1/sms_integration/{tenant_id}/{type}/{number} Cache-Control: no-cache Authorization: Bearer •••••••••••••••• Ocp-Apim-Subscription-Key: ••••••••••••••••
Response Variables
Variable | Description | Data Type |
---|---|---|
Response | Response defines the expected behavior and structure of the responses that clients can receive when interacting with the API. | string |
Message | Call message on success or error | String |
data.result.acknowledged | The key indicates whether the entity is acknowledged or not. | boolean |
data.result.modifiedCount | Modified count refers to the number of documents or records that were successfully updated or modified | integer |
data.result.upsertedId | Upserted ID refers to the unique identifier of a document or record that was inserted or updated during an upsert operation. | string |
data.result.upsertedCount | Upserted count indicates the total number of documents or records that were inserted or updated during an upsert operation. | integer |
data.result.matchedCount | Matched count refers to the number of documents or records that matched the specified criteria. | integer |
error | Contains information related to any error thrown by Call-Ai System. | object |
Response Schema
A successful request returns the HTTP 200 OK status code and a JSON response body as detailed below:
List SMS Gateway
The fetch SMS connector list api facilitates user to retrieve the list of SMS connectors for the specific tenant.
Endpoint URL
https://api.call-ai.com/basic-integrations/v1/basic/api/v1/sms_integration/{tenant_id}
Request Variables (Header Params)
You can retrieve the access token by entering the below-mentioned values in the Request Variables:
Variable | Description | Data Type |
---|---|---|
Ocp-Apim-Subscription-Key | Subscription Key of Tenant | String |
Authorization | Jwt token | String |
Request Variables (Path Params)
It takes a JSON request body with the following notable parameter:
Variable | Description | Data Type | Example value |
---|---|---|---|
tenant_id | A tenant ID is a unique identifier utilized to associate the data of each tenant with their specific account or instance. | String | tenant_12345 |
Sample Request
GET https://api.call-ai.com/basic-integrations/v1/basic/api/v1/sms_integration/{tenant_id} Cache-Control: no-cache Authorization: Bearer •••••••••••••••• Ocp-Apim-Subscription-Key: ••••••••••••••••
Response Variables
Variable | Description | Data Type |
---|---|---|
Response | Response defines the expected behavior and structure of the responses that clients can receive when interacting with the API. | string |
Message | Message represents the content that is being transmitted from the server to the client. | String |
data.result[]._id | A unique and distinctive label or code is assigned to an entity or individual within a particular context or system, serving the purpose of differentiation from others. | string |
data.result[].sms_connector[]._id | A unique and distinctive label or code is assigned to an entity or individual within a particular context or system, serving the purpose of differentiation from others. | string |
data.result[].sms_connector[].type | Type define the entity individual personality | string |
data.result[].sms_connector[].number | A number is a numerical sequence assigned to a telephone line or device to establish communication with other parties. | string |
data.result[].sms_connector[].id | It is a unique and specific label or code assigned to an entity, or individual to distinguish it from others within a given context or system. | string |
data.result[].sms_connector[].secret | The secret key used to authenticate with the SMS provider. | string |
data.result[].sms_connector[].is_activated | The key indicates whether the entity is activated or not. | boolean |
error | Error defines the expected behavior and structure of the error responses that clients can receive when interacting with the API. | object |
Response Schema
A successful request returns the HTTP 200 OK status code and a JSON response body as detailed below: