Open in
Connecter depuis Five9
Envoyez les appels Five9 vers un agent ThunderPhone via SIP avec AI Agent Connect, puis récupérez-les avec des en-têtes de routage lus par votre script IVR.
Votre script IVR Five9 envoie l'appelant à l'agent avec les détails d'appel de Five9. Lorsque l'agent a terminé, il raccroche avec des en-têtes de routage sur le SIP BYE, que le script lit dans des variables d'appel pour router l'appelant.
Avant de commencer
- Un agent ThunderPhone et une clé API d'organisation.
- L'option AI Agent Connect de Five9. Five9 la limite aux fournisseurs d'IA qu'il a agréés, et l'équipe d'implémentation de Five9 la configure : elle importe le modèle de script IVR du fournisseur, crée les variables d'appel et dirige le module Transfert tiers du script vers le fournisseur. ThunderPhone ne figure pas encore sur la liste des fournisseurs agréés par Five9 : consultez votre équipe de compte Five9 ou le support ThunderPhone avant de planifier son utilisation.
1. Créer le point de terminaison SIP
Le module de transfert tiers de Five9 compose un numéro de téléphone, et non une adresse SIP, et les intégrations Five9 d'autres fournisseurs authentifient Five9 par adresse source plutôt que par mot de passe. Créez donc un point de terminaison ip_allowlist avec le numéro que Five9 composera comme numéro d'accès entrant (voir
Plateformes qui composent un numéro de téléphone) :
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": "Five9",
"auth": "ip_allowlist",
"allowed_source_cidrs": ["FIVE9_SIGNALLING_RANGE_1", "FIVE9_SIGNALLING_RANGE_2"],
"dial_in_numbers": ["+14155550188"]
}'allowed_source_cidrs: les plages de signalisation SIP de vos centres de données Five9, fournies par Five9. Chacune doit être une plage IPv4 publique de/16ou plus précise (IPv6/48ou plus précise).dial_in_numbers: le numéro que le script Five9 composera, écrit tel que Five9 l'envoie. Il n'a pas besoin d'être un vrai numéro de téléphone. Il ne peut pas déjà être utilisé sur ThunderPhone, comme numéro de téléphone ou sur un autre point de terminaison : cela renvoie409.
Les adresses de Five9 sont partagées par tous ses clients ; tout autre client Five9 qui compose le numéro atteint donc votre agent. Lorsque vous choisissez le numéro, prenez-en un long que personne ne devinerait (jusqu'à 15 chiffres), assurez-vous que Five9 l'envoie à ThunderPhone plutôt que vers le réseau téléphonique, et ne le publiez pas.
2. Envoyer les appels avec du contexte
Demandez à l'équipe d'implémentation de Five9 de :
- Envoyer l'appel depuis le module Transfert tiers vers
sip:+14155550188@sip.thunderphone.com, avec le numéro à la fois dans l'URI de requête et dans l'en-têteTo. Le module utilise le numéro, avec le domaine SIP du fournisseur dans un en-tête. - L'envoyer via TLS (port 5061) ou TCP (port 5060). Le point de terminaison refuse UDP, et Five9 ne précise pas quel transport il utilise ; assurez-vous donc qu'il ne s'agit pas d'UDP.
- Activer Retour après appel tiers, afin que le script continue lorsque l'agent raccroche (Five9 autorise jusqu'à 3 600 secondes pour l'appel tiers).
Le guide Five9 répertorie les valeurs qu'il envoie (call.ANI, call.DNIS,
call.call_id, call.session_id, call.campaign_name et d'autres), mais pas les noms de leurs en-têtes. Les intégrations Five9 d'autres fournisseurs d'IA les documentent sur le réseau sous la forme
X-CallANI, X-CallDNIS, X-CallID, X-CallSessionID, X-CallCampaign
et X-AgentID ; vérifiez-les lors de votre premier appel de test. Chacune atteint le prompt sous forme de variable, par exemple
{{sip_x_callcampaign}}. X-CallID est stocké comme
external_call_id de l'appel.
3. Récupérer l'appel
L'agent renvoie l'appel : il prend congé et raccroche, et le BYE contient les
quatre en-têtes lus par le script Five9. Ajoutez ce numéro de transfert (voir
Ajouter le numéro de transfert) :
{
"name": "Five9 agent",
"action": "return",
"headers": {
"X-RouteType": "SkillTransfer",
"X-RouteValue": "Support",
"X-RouteReason": "{{handoff_intent}}",
"X-CustomMetaData": "handoff_id={{handoff_id}}"
}
}X-RouteTypeetX-RouteValueindiquent au script où envoyer l'appelant, ici vers la compétence Support. Parmi les valeurs documentées par d'autres fournisseurs pourX-RouteTypefigurentSkillTransfer,PhoneTransfer,HangupetDispositionOnly; convenez des valeurs avec la personne qui maintient le script. Pour plusieurs destinations, ajoutez un retour par destination avec un nom et une valeurX-RouteValuedifférents.X-RouteReasoncontient le libellé d'intention de l'agent, tel quebilling_dispute.X-CustomMetaDatacontient l'identifiant de transfert. LeBYEle contient également sous la formeX-TP-Handoff-Id, que Five9 ne lit pas.
Le script Five9 mappe les quatre en-têtes vers des variables d'appel. Pour le
résumé de l'agent, demandez au script d'appeler la recherche de transfert avec un module IVR Requête :
GET https://api.thunderphone.com/v1/calls/handoff?external_call_id= suivi de
call.call_id, avec un profil d'autorisation qui envoie
Authorization: Bearer et votre clé API. Voir
Rechercher un appel transféré.
Le tester
Appelez le script IVR, demandez à l'agent de parler à une personne et vérifiez que le script
effectue le routage de l'appelant avec les variables d'appel renseignées. Si l'appel n'atteint jamais
l'agent, vérifiez que le numéro dans l'URI de requête et l'en-tête To correspond au
numéro d'accès, que l'adresse source de Five9 figure dans allowed_source_cidrs, et
que l'appel est arrivé via TCP ou TLS. Ouvrez ensuite l'appel avec
GET /v1/calls/{call_id} : sip_headers doit répertorier x-callid, et
external_call_id doit correspondre à call.call_id dans Five9.
Limites
- Le guide Five9 documente les données de routage dans le
BYEet ne mentionne pas l'acceptation d'unREFER; le renvoi est donc un transfert à froid effectué par le script. - Five9 lit
X-RouteType,X-RouteValue,X-RouteReasonetX-CustomMetaData, mais pasUser-to-User. ThunderPhone envoie chaque valeur d'en-tête avec une longueur maximale de 256 octets. - Five9 recommande de limiter les en-têtes personnalisés à environ dix afin d'éviter la fragmentation des paquets.