ThunderPhone v3 sasa inapatikana.Anza mwenyewe, kuanzia 2¢/dakika.Soma tangazo

Contact centers

Unganisha kutoka Twilio

Tuma simu za Twilio kwa ejenti wa ThunderPhone kupitia SIP ukitumia CallSid, kisha uzirudishe kupitia referUrl yako huku uhamisho ukiwa katika anwani ya transfer.

TwiML yako hupiga anwani ya SIP ya ejenti ikiwa na CallSid ya simu katika kichwa. Mpigaji anapohitaji mtu, ejenti hutuma SIP REFER, Twilio hutuma anwani ya uhamisho yenye makabidhiano ndani yake kwa kishughulikiaji chako cha referUrl, na TwiML inayorejeshwa na kishughulikiaji chako huamua mpigaji aende wapi, kama vile kwenye foleni ya Flex.

Kabla ya kuanza

  • Ejenti wa ThunderPhone na ufunguo wa API wa shirika.
  • Twilio Programmable Voice, na mahali pa kutoa TwiML pamoja na kishughulikiaji cha referUrl: seva yako mwenyewe, au TwiML Bin na Twilio Function. Flex si lazima.

1. Unda kituo cha SIP

<Sip> ya Twilio hupokea jina la mtumiaji na nenosiri, kwa hivyo tumia kituo cha kawaida:

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

Hifadhi password kutoka kwenye jibu mara moja; huonyeshwa mara moja tu. Ili kukubali simu kutoka Twilio pekee pia, tazama Zuia anwani za IP za chanzo.

2. Tuma simu zikiwa na muktadha

Rejesha TwiML hii kwa simu unayotaka kukabidhi kwa ejenti:

<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 ni muhimu: Twilio hutumia UDP isipoiagizwa vinginevyo.
  • X-Call-ID hubeba CallSid. Twilio haijaeleza kichwa chake cha call-id, kwa hivyo ongeza hiki: ThunderPhone huihifadhi kama external_call_id ya simu. {{CallSid}} hufanya kazi katika TwiML Bin; kutoka seva yako mwenyewe, andika CallSid ya ombi linaloingia.
  • Ongeza muktadha zaidi kwa njia hiyo hiyo, kama vile &amp;X-Account-Id=12345. Ndani ya TwiML, andika & kama &amp;, kwa kuwa & isiyo na kinga si XML halali. Kila moja hufika kwenye prompt kama kigeu, hapa {{sip_x_account_id}}. Twilio inaruhusu vichwa vya x- na User-to-User, vilivyosimbwa kwa asilimia, huku URI nzima ikiwa chini ya vibambo 255 na vichwa vikiwa chini ya 1,024.
  • referUrl huiruhusu Twilio kukubali REFER ya ejenti; bila hiyo uhamisho hushindwa kwa hitilafu 13802. answerOnBridge="true" humweka mpigaji ameunganishwa hadi anwani mpya ijibu, hivyo uhamisho unaposhindwa unaweza kutumia njia mbadala.

Wijeti ya Studio ya Unganisha Simu Kwa haielezi vichwa maalum au referUrl, kwa hivyo kutoka Studio kabidhi simu kwa TwiML hii, kwa mfano kwa kutumia wijeti ya Uelekezaji Upya wa TwiML.

3. Pokea simu tena

Ejenti huhamisha kwa REFER ambayo anwani yake ya uhamishaji hubeba kitambulisho na nia ya hand-off. Ongeza nambari hii ya uhamishaji (tazama Ongeza nambari ya uhamishaji na Vichwa ndani ya anwani ya uhamishaji):

{
  "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 hutuma anwani nzima kwenye referUrl yako kama ReferTransferTarget, kwa mfano <sip:support@acme.sip.twilio.com?X-Handoff-Id=Zr3mY0b1Q9xWw2kPq4s7Tg&X-Handoff-Intent=billing_dispute>. Kishughulikiaji chako husoma vichwa kutoka humo na kurejesha TwiML ya mahali mpigaji simu anaelekezwa baadaye. Sehemu ya mtumiaji ya anwani (support) ni yako kuchagua, hivyo unaweza kuongeza nambari moja ya uhamishaji kwa kila lengwa na kuelekeza kwa kuitumia.

Twilio Function hii huweka mpigaji simu kwenye foleni ya Flex huku hand-off ikiwa sifa za jukumu na hutafuta muhtasari kwa kitambulisho cha hand-off. Utafutaji huendeshwa katika Function kwa sababu wijeti ya HTTP Request ya Studio haiwezi kutuma kichwa cha 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);
};

Hifadhi ufunguo wa API katika vigeu vya mazingira vya Function. Tazama Tafuta simu iliyofanyiwa hand-off kwa sehemu nyingine.

Ijaribu

Piga nambari ya Twilio inayorejesha TwiML iliyo hapo juu, mwombe ejenti akuunganishe na mtu, na uthibitishe kwamba kishughulikiaji chako cha referUrl kinapokea ReferTransferTarget yenye vichwa vyote viwili na kwamba mpigaji simu anafika kwenye foleni. Kisha fungua simu kwa GET /v1/calls/{call_id}: external_call_id inapaswa kuwa CallSid.

Vikomo

  • Twilio huweka kikomo cha Refer-To kuwa herufi 256. ThunderPhone huweka anwani kuwa 254 na huacha kichwa kisichotoshea, hivyo fanya majina na thamani za vichwa ziwe fupi.
  • Twilio haiandiki kuhusu kusoma vichwa kwenye BYE, hivyo urejeshaji hauwezi kubeba hand-off kurudi Twilio. Tumia REFER kama ilivyo hapo juu.
  • Twilio haikubali REFER kwenye simu iliyounganishwa kupitia <Conference> au <Queue>, hivyo piga ejenti kwa <Dial><Sip> kama ilivyo hapo juu.