https://vapi.ai/ logo
Join Discord
Powered by
How to configure calling number for Brazil outboun...
# support
m
Hello, I am in the process of developing an app with Node.js, Express, React, Prisma + MongoDB, etc... to test running on my server on my machine. And I would like to ask you some questions: ❔ How does the "outbound call" process work? ❔ Are there any pre-defined numbers to use? ❔ What number appears to the recipient? ❔ Can I mask/select a number? ❔ When you say "outbound calls," what is the origin? ❔ How do we handle "call recording"? What is the flow that the platform offers for this type of application: ❔ Create call → Configure number → Dial? ❔ Create call → System provides number → Dial? ❔ Anything else? Thank you!
v
To configure a calling number for Brazil outbound calls, you need to import a number from a provider like Twilio, Vonage, or Telnyx (free Vapi numbers do not support international calls). Once imported, use the following API structure to initiate an outbound call with your chosen number:
Copy code
json
{
  "assistantId": "your-assistant-id",
  "phoneNumberId": "your-imported-number-id",
  "customer": { "number": "+55XXXXXXXXXX" }
}
This ensures your selected number appears as the caller ID to the recipient. For more details, see the [Vapi outbound calling documentation](https://docs.vapi.ai/calls/outbound-calling). Source: - [Outbound Calling | Vapi Documentation](https://docs.vapi.ai/calls/outbound-calling)
v
Message marked as helpful by @maicon.jeison! 🎉
m
Thanks
s
Hi
here's a rundown for your Brazil setup: How outbound calls work You trigger a call via a POST to 
/call
with three things: your assistant ID, phone number ID, and the customer's number. Vapi handles the rest. Pre-defined numbers Vapi provides free US numbers but these can't make international calls. For Brazil you'll need to import a +55 number from Twilio, Vonage, or Telnyx — or use a BYO SIP trunk with a local Brazilian carrier. What the recipient sees Whatever number you import and pass as 
phoneNumberId
— so if you import a Brazilian +55 number, that's what shows on their caller ID. Can you mask/select a number? Yes — you control which number is used per call via 
phoneNumberId
. You can import multiple numbers and switch between them dynamically in your app logic. Call origin The call originates from your telephony provider's infrastructure (Twilio, Telnyx, etc.), not Vapi's. The recipient sees your configured number. Call recording Configured on the assistant via `artifactPlan`:
Copy code
json
{ "artifactPlan": { "recordingEnabled": true, "recordingFormat": "mp3" } }
Recordings are available via the dashboard or API after the call. You can also route them to your own S3 or GCS bucket. The correct flow Configure phone number → Create assistant → Trigger call via API. You explicitly choose which number to use - nothing is auto-assigned. Full docs here: docs.vapi.ai/calls/outbound-calling Let me know if you have any other questions! Best, Vapi Support
PreviousNext
Powered by