Open in
Forbind fra Twilio
Send Twilio-opkald til en ThunderPhone-agent via SIP med CallSid, og tag dem tilbage via din referUrl med overdragelsen i overførselsadressen.
Din TwiML ringer op til agentens SIP-adresse med opkaldets CallSid i en header.
Når opkalderen har brug for en person, sender agenten en SIP-REFER, Twilio sender
overførselsadressen med overdragelsen i den til din referUrl-behandler, og den
TwiML, som din behandler returnerer, afgør, hvor opkalderen ender, f.eks. i en Flex-kø.
Før du starter
- En ThunderPhone-agent og en organisations-API-nøgle.
- Twilio Programmable Voice og et sted at levere TwiML og en
referUrl- behandler: din egen server eller en TwiML Bin og en Twilio Function. Flex er valgfrit.
1. Opret SIP-slutpunktet
Twilios <Sip> bruger et brugernavn og en adgangskode, så brug et standardendpunkt:
curl -X POST https://api.thunderphone.com/v1/sip-endpoints \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"agent_id": 12, "name": "Twilio"}'Gem password fra svaret med det samme; den vises kun én gang. Hvis du også kun
vil acceptere opkald fra Twilio, se
Begræns kilde-IP-adresser.
2. Send opkald med kontekst
Returnér denne TwiML for det opkald, du vil overdrage til agenten:
<Response>
<Dial answerOnBridge="true" referUrl="https://YOUR_SERVER/thunderphone-refer">
<Sip username="tp409667538f83" password="YOUR_ENDPOINT_PASSWORD">sip:agent-12-jhxmginwjx@sip.thunderphone.com;transport=tls?X-Call-ID={{CallSid}}</Sip>
</Dial>
</Response>;transport=tlser vigtigt: Twilio bruger UDP, medmindre du angiver andet.X-Call-IDindeholderCallSid. Twilio dokumenterer ikke en egen call-id-header, så tilføj denne: ThunderPhone gemmer den som opkaldetsexternal_call_id.{{CallSid}}virker i en TwiML Bin; fra din egen server skal du skriveCallSidfra den indgående anmodning.- Tilføj mere kontekst på samme måde, f.eks.
&X-Account-Id=12345. Inde i TwiML skal du skrive&som&, da et nøgent&er ugyldig XML. Hver når prompten som en variabel, her{{sip_x_account_id}}. Twilio tilladerx--headere ogUser-to-User, procentkodet, med hele URI'en på under 255 tegn og headerne på under 1.024. referUrllader Twilio acceptere agentensREFER; uden den mislykkes overførslen med fejl 13802.answerOnBridge="true"holder opkalderen forbundet, indtil den nye destination svarer, så en mislykket overførsel kan falde tilbage.
Studios Forbind opkald til-widget dokumenterer ikke brugerdefinerede headere
eller referUrl, så overdrag opkaldet fra Studio til denne TwiML, f.eks. med en
TwiML-omdirigering-widget.
3. Få opkaldet tilbage
Agenten overfører med en REFER, hvis overførselsadresse indeholder
overdragelses-id og hensigt. Tilføj dette overførselsnummer (se
Tilføj overførselsnummeret
og Headere i overførselsadressen):
{
"name": "Twilio support",
"number": "sip:support@acme.sip.twilio.com",
"headers": {"X-Handoff-Id": "{{handoff_id}}", "X-Handoff-Intent": "{{handoff_intent}}"},
"headers_in_uri": true
}Twilio sender hele adressen til din referUrl som ReferTransferTarget, for
eksempel <sip:support@acme.sip.twilio.com?X-Handoff-Id=Zr3mY0b1Q9xWw2kPq4s7Tg&X-Handoff-Intent=billing_dispute>.
Din handler læser headerne ud af den og returnerer TwiML for, hvor opkalderen
sendes hen derefter. Adressens brugerdel (support) vælger du selv, så du kan
tilføje ét overførselsnummer pr. destination og route ud fra det.
Denne Twilio Function sætter opkalderen i kø til Flex med overdragelsen som
opgaveattributter og slår resuméet op efter overdragelses-id. Opslaget kører i
en Function, fordi Studios HTTP Request-widget ikke kan sende headeren
Authorization:
exports.handler = async (context, event, callback) => {
const target = (event.ReferTransferTarget || "").replace(/^<|>$/g, "");
const params = new URLSearchParams(target.split("?")[1] || "");
const handoffId = params.get("X-Handoff-Id") || "";
const attributes = { handoff_id: handoffId, intent: params.get("X-Handoff-Intent") || "" };
if (handoffId) {
const response = await fetch(
"https://api.thunderphone.com/v1/calls/handoff?handoff_id=" + encodeURIComponent(handoffId),
{ headers: { Authorization: "Bearer " + context.THUNDERPHONE_API_KEY } }
);
if (response.ok) {
const call = await response.json();
attributes.summary = (call.handoff && call.handoff.summary) || "";
}
}
const twiml = new Twilio.twiml.VoiceResponse();
twiml.enqueue({ workflowSid: context.FLEX_WORKFLOW_SID }).task({}, JSON.stringify(attributes));
callback(null, twiml);
};Gem API-nøglen i Function-miljøvariablerne. Se Slå et overdraget opkald op for de øvrige felter.
Test det
Ring til et Twilio-nummer, der returnerer TwiML-koden ovenfor, bed agenten om
en person, og kontrollér, at din referUrl-handler modtager
ReferTransferTarget med begge headere, og at opkalderen når køen. Åbn derefter
opkaldet med GET /v1/calls/{call_id}: external_call_id skal være CallSid.
Begrænsninger
- Twilio begrænser
Refer-Totil 256 tegn. ThunderPhone holder adressen på 254 og udelader en header, der ikke passer, så hold headernavne og værdier korte. - Twilio dokumenterer ikke læsning af headere på en
BYE, så en returnering kan ikke føre overdragelsen tilbage til Twilio. Brug enREFERsom ovenfor. - Twilio accepterer ikke en
REFERpå et opkald, der er forbundet via<Conference>eller<Queue>, så ring til agenten med<Dial><Sip>som ovenfor.