SocialMati
Voice & CallingAccount SID + Auth tokenConfirm pricing before publishing

Twilio (SMS & Voice)

Phone calls for AI Calling agents (outbound, inbound receptionist, transfers, recordings) and SMS from workflows.

AProvider definition

Provider
Twilio (SMS & Voice)
What it does
SMS from workflows and phone calls for AI Calling Agents (outbound, inbound receptionist, transfers, recordings, SIP). Point your Twilio number's Voice webhook to the inbound URL below.
Why we need it
Phone calls for AI Calling agents (outbound, inbound receptionist, transfers, recordings) and SMS from workflows.
Used in
AI Calling · Workflows (SMS)
AI capabilities
telephony

BAccount requirements

Account type
Twilio account
Prerequisites
  • A voice-capable phone number
  • Regulatory bundle/KYC for numbers in some countries (including India)

CConnection method

Authentication
Account SID + Auth token
Where to enter it
  • Your workspace: App → Integrations → Providers & API keysWorkspace owner or admin. Keys added here are used only by your workspace (AI keys here don't use plan credits).

Setup steps

  1. 1Sign in to console.twilio.com and copy the Account SID and Auth token from the dashboard.
  2. 2Buy or port a phone number with Voice capability.
  3. 3On the number's configuration, set “A call comes in” to the Voice webhook shown below (HTTP POST).
  4. 4Enter the SID, token and from-number (E.164, e.g. +15551234567) in the application and click Test.

DPermissions & API scopes

No OAuth scopes — access is controlled by the key or token itself. Restrict keys to the APIs listed in the setup steps where the provider allows it.

This list is generated from the scopes the application's code requests.

EFree vs paid

Free account / free API access
Trial account with small credit; trial calls play a notice and can only reach verified numbers.
Card or billing account required?
Usually required for production use.
Paid plan / costs
Pay-as-you-go per minute and per number per month.
Quota and usage limits
Provider-specific rate limits.
Not yet verified. Confirm on the provider's official pricing page before publishing.

FSetup screenshots

Capture each step with real values masked. Save images as public/docs/integrations/twilio/1.png … 10.png and they appear here automatically.

  1. Screenshot to add
    1. Account login / creation
    The provider's sign-in or sign-up page.
  2. Screenshot to add
    2. Developer console
    The developer console or dashboard home.
  3. Not applicable
    3. Project / app creation
    Creating the app or project used for this integration.
  4. Not applicable
    4. API enablement
    The API or product enabled for the project.
  5. Not applicable
    5. OAuth configuration
    Consent screen / OAuth settings with the redirect URIs.
  6. Screenshot to add
    6. API key / credentials creation
    Creating the key, secret or token (mask the value).
  7. Not applicable
    7. Permissions / scopes
    The scopes or permissions requested or approved.
  8. Screenshot to add
    8. Billing / quota settings
    Billing, credits or quota page.
  9. Screenshot to add
    9. Application connection
    The provider card in our application with fields filled (secrets masked).
  10. Screenshot to add
    10. Successful connection
    The green Test result or the connected account listed.

GApplication configuration

Never include real API keys, client secrets, access tokens or passwords in screenshots, tickets or documentation. Values below are field names and examples only.

FieldRequiredExample / defaultNotes
Account SIDYes—
Auth tokenYes••••••••Stored encrypted; shown masked after saving.
From number (E.164)Yes+15551234567
Your voice cost per minute (USD)Optional0.014Used for calling cost analytics.

Paste these into the provider's console

Voice webhook (inbound calls)
https://api.socialmati.com/api/calling/hook/twilio/inbound

HTesting

  1. 1Click Test — it shows the Twilio account name.
  2. 2Calling → Agents → open an agent → Test call to your own phone.

ITroubleshooting

ProblemWhat to do
21608 / unverified numberTrial accounts can only call verified numbers. Upgrade the account or verify the number.
Inbound calls not answeredThe number's Voice webhook must point to the URL shown below.
Invalid credentialsThe key or token is wrong, revoked or from another project. Create a new one and paste it again, then click Test.
Missing permissionsThe key's project or role doesn't include this API. Grant access or create the key in the right project.
API not enabledEnable the API/product for the project or app in the provider console and wait a few minutes.
Quota exceededWait for the quota window to reset (see section E) or request a higher quota / add credits.
Account not eligibleCheck the account requirements in section B (e.g. business/professional account, verified property, registered organisation).
Billing requiredAdd a payment method or prepaid credits on the provider account (see section E).

JDisconnect & security

Revoke access at the provider
Rotate the Auth token in the Twilio console (Account → API keys & tokens) and update the application.
Disconnect in the application
App → Integrations → Providers & API keys → open the card → Remove / Disconnect. Connected accounts can be disconnected per brand.
Rotate credentials
Create the new key or secret first, paste it into the same card and Test, then delete the old one at the provider — no downtime.
How credentials are stored
Encrypted at rest with AES-256-GCM using the server's ENCRYPTION_KEY, shown masked after saving, never returned to the browser, and used only from the API server.
What data the application can access
Call audio, recordings (if enabled) and SMS content flow through Twilio.

Other Voice & Calling providers

Start Free