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:

  1. Import the Pingram number and assign the agent.
  2. 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:

  1. Open Phone Numbers.
  2. Choose Import number, then From SIP Trunk.
  3. Set Phone Number to the Pingram number in E.164, with the leading +.
  4. 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.
  5. Leave the outbound trunk empty. This setup only sends calls to ElevenLabs. It does not ask ElevenLabs to dial out through Pingram.
  6. Import, then Assign Agent on that number.
The leading + has to match

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"
}