Bland AI
Bland is an AI phone-agent platform. CenterLeap uses it as the voice that speaks on calls, bridged in over a Telnyx SIP path so calls show our own number as caller ID. This guide covers the agent (persona) configuration; the low-level SIP wiring is in the Bland + Telnyx SIP guide.
On this page
Architecture
Because Bland's BYO-SIP outbound path is unreliable, CenterLeap dials the customer from Telnyx (showing our number) and, on answer, bridges a SIP leg into Bland as an inbound call. Bland answers that inbound leg with the configured agent. So the agent config lives on the inbound number, not on a per-call outbound request.
Telnyx dials customer (caller ID = our number)
└─ on answer → SIP bridge into Bland inbound number
└─ Bland answers as the configured agent (voice + prompt)1. Get an API key
From the Bland dashboard → API Keys. Send it as the authorization header on all requests (no Bearer prefix).
2. Configure the inbound agent
Set the agent on the Bland inbound number that the SIP bridge targets. The key fields: prompt (persona), voice, first_sentence (leave empty to have the agent listen first), max_duration, and record.
curl -s -X POST "https://api.bland.ai/v1/inbound/%2B1XXXXXXXXXX" \
-H "authorization: $BLAND_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "You are Sara, a recruiting assistant ...",
"first_sentence": "",
"voice": "YOUR_VOICE_ID",
"max_duration": 4,
"record": true
}'3. The persona prompt
The prompt is the agent's entire behavior. A production recruiting prompt should include: a listen-first rule (say nothing until a human speaks), a “process what they actually said” rule so the agent exits politely on disqualifiers instead of plowing through a script, the ordered questions, and an explicit voicemail rule.
4. Voicemail handling
This is Bland's weak spot when bridged inbound: it cannot reliably tell that it reached a voicemail. CenterLeap compensates at the carrier layer — Telnyx answering-machine detection fires a beep event, the agent leg is torn down, and a pre-recorded message is played into the mailbox. The Bland prompt is also told to say nothing to a recorded greeting and never claim it left a message.
If voicemail accuracy is the priority, see the Vapi integration, which provides native voicemail detection.
5. Configure CenterLeap
| BLAND_API_KEY | Bland API key (authorization header). |
| BLAND_ANDY_PERSONA_ID | Saved persona id, if using personas. |
| BLAND_ANDY_VOICE_ID | Voice id for the agent. |
| BLAND_WEBHOOK_URL | Where Bland posts call events (optional). |
6. Test
Read the current inbound-number config back to confirm it saved:
curl -s "https://api.bland.ai/v1/inbound/%2B1XXXXXXXXXX" \ -H "authorization: $BLAND_API_KEY"
Then place a real bridged call through the Telnyx path and listen end to end — audio bugs (talking over a greeting, wrong voice) only surface on a live call.