ThunderPhone v3 er live.Selvbetjening fra 2 cent pr. minut.Læs mere om lanceringen

Contact centers

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=tls er vigtigt: Twilio bruger UDP, medmindre du angiver andet.
  • X-Call-ID indeholder CallSid. Twilio dokumenterer ikke en egen call-id-header, så tilføj denne: ThunderPhone gemmer den som opkaldets external_call_id. {{CallSid}} virker i en TwiML Bin; fra din egen server skal du skrive CallSid fra den indgående anmodning.
  • Tilføj mere kontekst på samme måde, f.eks. &amp;X-Account-Id=12345. Inde i TwiML skal du skrive & som &amp;, da et nøgent & er ugyldig XML. Hver når prompten som en variabel, her {{sip_x_account_id}}. Twilio tillader x--headere og User-to-User, procentkodet, med hele URI'en på under 255 tegn og headerne på under 1.024.
  • referUrl lader Twilio acceptere agentens REFER; 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-To til 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 en REFER som ovenfor.
  • Twilio accepterer ikke en REFER på et opkald, der er forbundet via <Conference> eller <Queue>, så ring til agenten med <Dial><Sip> som ovenfor.