📋

Outbound calls from API


Outbound calls from API

Make programmatic outbound calls via REST API. Integrate your AI assistant with your existing PBX or use the AI4CALL telephone network to automatically and intelligently contact customers and prospects.

Outbound call from your PBX

Initiate outbound calls from your business PBX. The AI assistant connects directly to your VoIP PBX to manage automatic conversations with your customers, maintaining full control over your telephony infrastructure.

🔌

API Documentation

POST
https://outcall.ai4call.com/webhook/outbound_call_pbx
Headers
X-APIKEY-SECRET-AI4CALL: sk_0***********************************************************fb49
Body Parameters
  • dst required
    Destination phone number in the format required by your PBX (E.164 +3902XXXXXXXX; Local 02XXXXXXXX)
  • callerId required
    Caller ID number displayed in the format required by your PBX (E.164 +3902XXXXXXXX; Local 02XXXXXXXX)
  • apiKey_assistente required
    API key of the AI assistant that will speak with the called party
  • ip_pbx required
    Public IP of the PBX. Must be one of the authorized public IPs. You can see authorized public IPs in "MANAGEMENT → Enable IP"
    Must be one of the authorized public IPs.
    You can see authorized public IPs in "MANAGEMENT → Enable IP"
  • sip_port required
    SIP port of the PBX (standard 5060)
  • Add-Prompt optional
    Additional prompt to customize assistant behavior
Example Request
{
  "dst": "331XXXXXXXXX",
  "callerId": "02825XXXXX",
  "apiKey_assistente": "ai4call_sk_xxxxxxxx",
  "ip_pbx": "xxx.xxx.xxx.xxx",
  "sip_port": "5060",
  "Add-Prompt": "Always greet the user by name, his name is MARIO ROSSI"
}
Note: the API key must be generated from the portal in the "SECURITY" → API Key" section

Outbound call with AI4CALL trunk

Make outbound calls using the AI4CALL telephone network. No PBX configuration required: use our VoIP trunks to contact any number worldwide with transparent pricing.

🔌

API Documentation

POST
https://outcall.ai4call.com/webhook/outbound_call
Headers
X-APIKEY-SECRET-AI4CALL: sk_0***********************************************************fb49
Body Parameters
  • dst required
    Destination phone number in E.164 format +3902XXXXXXXX
  • callerId required
    Caller ID number displayed in E.164 format +3902XXXXXXXX. Must be an AI4CALL number (demo or purchased) present in your account. You can see your numbers, demo and purchased, in "AI4CALL NUMBERS → Routing"
    Must be an AI4CALL number (demo or purchased) present in your account.
    You can see your numbers, demo and purchased, in "AI4CALL NUMBERS → Routing"
  • apiKey_assistente required
    API key of the AI assistant that will speak with the called party
  • Add-Prompt optional
    Additional prompt to customize assistant behavior
Example Request
{
  "dst": "+39331XXXXXXXXX",
  "callerId": "+3902825XXXXX",
  "apiKey_assistente": "ai4call_sk_xxxxxxxx",
  "Add-Prompt": "Always greet the user by name, his name is MARIO ROSSI"
}
Note: the API key must be generated from the portal in the "SECURITY" → API Key" section

The call from PBX uses your business PBX: the AI assistant connects to your PBX to manage the conversation. The call from AI4CALL trunk uses our telephony infrastructure instead: no PBX needed, you just need an AI4CALL number and you can call from any application.

Yes, you can add a custom prompt via the "Add-Prompt" parameter in the API request. This allows you to adapt the assistant's behavior based on the specific call context or customer information.

We support the international E.164 format (+39331XXXXXXX) for trunk calls. For PBX calls, we also accept local formats (02XXXXXXXX) based on your PBX configuration. The caller number must always be authorized in your account.

The limit depends on your plan: bundle profiles have a fixed number of simultaneous channels, while the consumption profile allows you to configure the number of channels according to your needs. Contact support to increase limits.

Technology and people:
together, zero waiting and a thousand solutions.

Ready to transform
your calls?

Request a free demo and discover how AI4CALL can revolutionize your business


Some of the ai4call users