ElevenLabs
A Pingram number can hand the call to an ElevenLabs agent. Inbound, the caller reaches your number and Pingram sends the call to ElevenLabs. Outbound, Pingram dials the person and, when they answer, including voicemail, sends that call to ElevenLabs. The agent, voice, and tools are the ones on that number in ElevenLabs.
Two things are set up in ElevenLabs, not in the Pingram playground:
- Import the Pingram number and assign the agent.
- If the agent should move the caller to a person, add a webhook tool. That tool can cold-transfer, play a hold announcement or hold audio, or brief the person who answers before the caller is connected. ElevenLabs’ own transfer does not cover those.
Import the number
Pingram sends the call to ElevenLabs at:
sip:+14165550100@sip.rtc.elevenlabs.io:5060;transport=tcp+14165550100 is your Pingram number. The leading + is required, and the number you import has to use that same form.
In the ElevenLabs Agents dashboard:
- Open Phone Numbers.
- Choose Import number, then From SIP Trunk.
- Set Phone Number to the Pingram number in E.164, with the leading
+. - On inbound, leave media encryption on Allowed. Leave allowed numbers empty, and leave allowed source addresses open (
0.0.0.0/0), unless you already restrict them. Pingram does not send a SIP username or password. - Leave the outbound trunk empty. This setup only sends calls to ElevenLabs. It does not ask ElevenLabs to dial out through Pingram.
- Import, then Assign Agent on that number.
If the imported number is +14165550100, the call has to arrive as
sip:+14165550100@…. A number saved without the + will not match, and
ElevenLabs will not pick up.
Inbound in the Pingram dashboard: choose ElevenLabs and assign the flow to that number. Outbound: choose ElevenLabs and place the call from that number. The same imported ElevenLabs number receives both.
ElevenLabs documents the same import dialog under SIP trunking.
Transfer webhook
Add a webhook tool on the ElevenLabs agent. Pingram moves the live call when that tool runs.
The call to ElevenLabs includes the header X-Pingram-Tracking-Id. ElevenLabs turns that header into the dynamic variable sip_pingram_tracking_id. The tool URL uses it so the transfer hits this call and no other.
Auth connection
In ElevenLabs, under Auth Connections, add a Bearer Token connection.
| Field | Value |
|---|---|
| Name | Pingram Auth |
| Auth type | Bearer Token |
| Provider | Pingram |
| Token | A secret API key (pingram_sk_…) |
Create the key on API Keys in the Pingram dashboard. ElevenLabs sends Authorization: Bearer <token>. Leave the token field empty when you edit the connection later if you want to keep the saved token.
Select this connection on the tool. The tool request is authenticated as that Pingram account, and the account has to own the call.
Tool
| Field | Value |
|---|---|
| Name | transfer |
| Description | Move the caller to a phone number. Call this when they ask for a person. |
| Method | POST |
| URL | https://api.pingram.io/voice/calls/{{sip_pingram_tracking_id}}/transfer |
| Authentication | The Bearer connection from above |
| Response | All fields |
Use the API host for the account. The voice playground shows the host for the account you have open.
| Region | Host |
|---|---|
| US | api.pingram.io |
| Canada | api.ca.pingram.io |
| Europe | api.eu.pingram.io |
{{ starts an ElevenLabs variable. In the URL field, type {{ and pick sip_pingram_tracking_id.
Path parameter
The {sip_pingram_tracking_id} segment in the URL is a path parameter. Configure it as a dynamic variable with the same name. Do not ask the model to invent this value.
| Data type | Identifier | Value type | Variable name |
|---|---|---|---|
| String | sip_pingram_tracking_id |
Dynamic Variable | sip_pingram_tracking_id |
Body
The body is JSON. Add one property per field. to is required. It is a US or Canada number in E.164, such as +14165550100.
Each property has one value type:
- Constant Value sends the same text on every call. Use it when the destination, the hold line, or the briefing never changes.
- LLM Prompt asks the model to fill the field from the conversation. The property description is the instruction. Use it when the number or the sentence depends on what was said.
- Dynamic Variable reads a value ElevenLabs already has. The tracking id uses this. The destination usually does not.
holdSay and receiverSay can be at most 400 characters.
Transfer modes
Any of holdSay, holdAudio, or receiverSay parks the caller until the other person is ready. Leave all three off and the caller is connected as soon as that person answers. On an inbound call, the person who answers sees the original caller’s number. On an outbound call, they see your Pingram number.
Cold transfer
The caller hears ringing, then the other person.
In the tool, add to as a Constant Value when it is always the same number, or as an LLM Prompt when the agent chooses it. Description for the prompt: “E.164 phone number to dial, with a leading +. US and Canada only.”
{ "to": "+14165550100"}Hold announcement
holdSay is spoken once to the caller while they wait. With no hold audio, they then hear ringing.
{ "to": "+14165550100", "holdSay": "Please hold while I connect you."}A fixed line is a Constant Value. A line the agent should write is an LLM Prompt, for example: “One short sentence telling the caller who you are connecting them to.”
Hold audio
holdAudio loops until the call connects. Built-in tracks:
| Value | What the caller hears |
|---|---|
builtin:soft-piano |
Soft piano |
builtin:calm |
Calm |
builtin:bright |
Bright |
An https:// URL of an MP3 or WAV also works. If holdSay and holdAudio are both set, the sentence is spoken once and then the audio plays.
{ "to": "+14165550100", "holdSay": "Please hold while I connect you.", "holdAudio": "builtin:soft-piano"}holdAudio is almost always a Constant Value.
Briefing
receiverSay is spoken to the person who answers, before the caller is connected. The caller stays on hold through that sentence.
{ "to": "+14165550100", "holdSay": "Please hold while I connect you.", "holdAudio": "builtin:soft-piano", "receiverSay": "Sam is calling to confirm the appointment."}A fixed briefing is a Constant Value. A briefing from the conversation is an LLM Prompt, for example: “One sentence for the person who answers: who is calling and why.”
A successful transfer responds with:
{ "message": "Transfer started to +14165550100"}