Open in
Σύνδεση από το Twilio
Στείλτε κλήσεις Twilio σε έναν πράκτορα ThunderPhone μέσω SIP με το CallSid και επιστρέψτε τες μέσω του referUrl σας, με την παράδοση στη διεύθυνση μεταφοράς.
Το TwiML σας καλεί τη διεύθυνση SIP του πράκτορα με το CallSid της κλήσης σε μια κεφαλίδα.
Όταν ο καλών χρειάζεται άνθρωπο, ο πράκτορας στέλνει ένα SIP REFER, το Twilio προωθεί τη
διεύθυνση μεταφοράς με την παράδοση μέσα σε αυτήν στον χειριστή referUrl σας και το
TwiML που επιστρέφει ο χειριστής σας αποφασίζει πού θα μεταβεί ο καλών, όπως σε μια ουρά Flex.
Πριν ξεκινήσετε
- Έναν πράκτορα ThunderPhone και ένα κλειδί API οργανισμού.
- Twilio Programmable Voice και ένα σημείο για την εξυπηρέτηση TwiML και ενός
χειριστή
referUrl: ο δικός σας διακομιστής ή ένα TwiML Bin και μια Twilio Function. Το Flex είναι προαιρετικό.
1. Δημιουργήστε το τελικό σημείο SIP
Το <Sip> του Twilio δέχεται όνομα χρήστη και κωδικό πρόσβασης, επομένως χρησιμοποιήστε ένα τυπικό τελικό σημείο:
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"}'Αποθηκεύστε αμέσως το password από την απόκριση· εμφανίζεται μία φορά. Για να
δέχεστε επίσης κλήσεις μόνο από το Twilio, ανατρέξτε στην ενότητα
Περιορισμός IP προέλευσης.
2. Στείλτε κλήσεις με περιβάλλον
Επιστρέψτε αυτό το TwiML για την κλήση που θέλετε να παραδώσετε στον πράκτορα:
<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είναι σημαντικό: το Twilio χρησιμοποιεί UDP, εκτός αν ορίσετε διαφορετικά. - Το
X-Call-IDμεταφέρει τοCallSid. Το Twilio δεν τεκμηριώνει δική του κεφαλίδα αναγνωριστικού κλήσης, επομένως προσθέστε αυτήν: το ThunderPhone το αποθηκεύει ωςexternal_call_idτης κλήσης. Το{{CallSid}}λειτουργεί σε TwiML Bin· από τον δικό σας διακομιστή, γράψτε τοCallSidτου εισερχόμενου αιτήματος. - Προσθέστε περισσότερο περιβάλλον με τον ίδιο τρόπο, όπως
&X-Account-Id=12345. Μέσα σε TwiML, γράψτε&ως&, καθώς ένα απλό&δεν είναι έγκυρο XML. Κάθε τιμή φτάνει στο prompt ως μεταβλητή, εδώ{{sip_x_account_id}}. Το Twilio επιτρέπει κεφαλίδεςx-καιUser-to-User, με ποσοστιαία κωδικοποίηση, με ολόκληρο το URI κάτω από 255 χαρακτήρες και τις κεφαλίδες κάτω από 1.024. - Το
referUrlεπιτρέπει στο Twilio να αποδεχτεί τοREFERτου πράκτορα· χωρίς αυτό η μεταφορά αποτυγχάνει με το σφάλμα 13802. ΤοanswerOnBridge="true"διατηρεί τον καλούντα συνδεδεμένο μέχρι να απαντήσει ο νέος προορισμός, ώστε μια αποτυχημένη μεταφορά να μπορεί να χρησιμοποιήσει εναλλακτική διαδρομή.
Το γραφικό στοιχείο Σύνδεση κλήσης με του Studio δεν τεκμηριώνει προσαρμοσμένες κεφαλίδες ή
referUrl, επομένως από το Studio δρομολογήστε την κλήση σε αυτό το TwiML, για παράδειγμα με ένα
γραφικό στοιχείο Ανακατεύθυνση TwiML.
3. Λάβετε την κλήση πίσω
Ο πράκτορας μεταφέρει την κλήση με ένα REFER, του οποίου η διεύθυνση μεταφοράς περιέχει το αναγνωριστικό και την πρόθεση μεταβίβασης. Προσθέστε αυτόν τον αριθμό μεταφοράς (δείτε
Προσθήκη αριθμού μεταφοράς
και Κεφαλίδες μέσα στη διεύθυνση μεταφοράς):
{
"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 στέλνει ολόκληρη τη διεύθυνση στο referUrl σας ως ReferTransferTarget, για
παράδειγμα <sip:support@acme.sip.twilio.com?X-Handoff-Id=Zr3mY0b1Q9xWw2kPq4s7Tg&X-Handoff-Intent=billing_dispute>.
Ο χειριστής σας διαβάζει τις κεφαλίδες από αυτήν και επιστρέφει TwiML για το επόμενο
σημείο προώθησης του καλούντος. Το τμήμα χρήστη της διεύθυνσης (support) το επιλέγετε εσείς, ώστε να μπορείτε
να προσθέσετε έναν αριθμό μεταφοράς ανά προορισμό και να δρομολογείτε βάσει αυτού.
Αυτή η Συνάρτηση Twilio τοποθετεί τον καλούντα στην ουρά του Flex με τη μεταβίβαση ως
χαρακτηριστικά εργασίας και αναζητά τη σύνοψη βάσει αναγνωριστικού μεταβίβασης. Η αναζήτηση εκτελείται σε
Συνάρτηση επειδή το γραφικό στοιχείο Αίτημα HTTP του Studio δεν μπορεί να στείλει την κεφαλίδα 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);
};Διατηρήστε το κλειδί API στις μεταβλητές περιβάλλοντος της Συνάρτησης. Δείτε Αναζήτηση μεταβιβασμένης κλήσης για τα υπόλοιπα πεδία.
Δοκιμάστε το
Καλέστε έναν αριθμό Twilio που επιστρέφει το παραπάνω TwiML, ζητήστε από τον πράκτορα να μιλήσετε με ένα άτομο,
και ελέγξτε ότι ο χειριστής referUrl λαμβάνει το ReferTransferTarget με αμφότερες τις
κεφαλίδες και ότι ο καλών φτάνει στην ουρά. Στη συνέχεια, ανοίξτε την κλήση με
GET /v1/calls/{call_id}: το external_call_id πρέπει να είναι το CallSid.
Περιορισμοί
- Το Twilio περιορίζει το
Refer-Toστους 256 χαρακτήρες. Το ThunderPhone διατηρεί τη διεύθυνση στους 254 και παραλείπει μια κεφαλίδα που δεν χωράει, επομένως διατηρήστε σύντομα τα ονόματα και τις τιμές κεφαλίδων. - Το Twilio δεν τεκμηριώνει την ανάγνωση κεφαλίδων σε
BYE, επομένως μια επιστροφή δεν μπορεί να μεταφέρει τη μεταβίβαση πίσω στο Twilio. Χρησιμοποιήστε έναREFERόπως παραπάνω. - Το Twilio δεν δέχεται
REFERσε κλήση που συνδέεται μέσω<Conference>ή<Queue>, επομένως καλέστε τον πράκτορα με<Dial><Sip>όπως παραπάνω.