Open in
Se connecter depuis NICE CXone
Envoyez les appels NICE CXone vers un agent ThunderPhone depuis un script Studio avec le ContactID dans un en-tête SIP, puis récupérez le transfert de l
Votre script CXone Studio passe un appel à l’agent avec des en-têtes SIP qui transmettent l’identifiant du contact et tout autre contexte. Lorsque l’agent a terminé, il raccroche, puis une action d’API REST dans le script récupère le transfert.
Avant de commencer
- Un agent ThunderPhone et une clé API d’organisation.
- Un groupe de trunks SIP CXone qui accepte les en-têtes personnalisés. Votre représentant de compte NICE doit activer ce paramètre avant que CXone ne les envoie.
1. Créer le point de terminaison SIP
Placecall compose un numéro de téléphone via un groupe de trunks CXone, et non une adresse SIP.
NICE ne documente pas les identifiants SIP pour celui-ci, et l’intégration CXone d’un autre fournisseur d’IA utilise TLS avec une liste d’autorisation d’adresses IP. Créez donc un point de terminaison ip_allowlist avec le numéro que le script composera comme numéro d’appel 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": "NICE CXone",
"auth": "ip_allowlist",
"allowed_source_cidrs": ["CXONE_SIGNALLING_RANGE_1", "CXONE_SIGNALLING_RANGE_2"],
"dial_in_numbers": ["+14155550188"]
}'allowed_source_cidrs: les plages de signalisation SIP de votre cluster CXone, fournies par NICE. Chacune doit être une plage IPv4 publique de/16ou plus spécifique (IPv6/48ou plus spécifique).dial_in_numbers: le numéro que Placecall composera, écrit de la manière dont CXone l’envoie. Il n’a pas besoin d’être un véritable numéro de téléphone. Il ne peut pas déjà être utilisé dans ThunderPhone, comme numéro de téléphone ou sur un autre point de terminaison : cela renvoie409.
Les adresses de CXone sont partagées entre tous ses clients. Tout autre client CXone qui compose ce numéro atteint donc votre agent. Lorsque vous choisissez le numéro, prenez-en un long que personne ne devinerait facilement (jusqu’à 15 chiffres), assurez-vous que CXone l’envoie à ThunderPhone plutôt que vers le réseau téléphonique, et ne le publiez pas.
2. Envoyer les appels avec le contexte
Dans votre script Studio, avant Placecall :
- Ajoutez une action Sipputheader avec l’en-tête
X-Call-IDet la valeur deContactID. CXone n’envoie aucun en-tête d’identifiant d’appel propre ; ThunderPhone stocke celui-ci commeexternal_call_idde l’appel. - Ajoutez une action Sipputheader pour chaque autre valeur que l’agent doit connaître, par exemple
X-Skilldéfini sursupport. Elle atteint le prompt sous la forme{{sip_x_skill}}. Sipputheader accepteUser-to-User, tout en-têteX-et la plupart des en-têtesP-; NICE recommande des valeurs de 256 caractères ou moins.
Ensuite, utilisez Placecall vers ce numéro, via un groupe de trunks qui l’envoie à sip.thunderphone.com avec le numéro à la fois dans l’URI de requête et dans l’en-tête To. Le point de terminaison accepte TLS (port 5061) ou TCP (port 5060) et refuse UDP. NICE ne documentant pas le transport du trunk, assurez-vous qu’il ne s’agit pas d’UDP.
3. Récupérer l’appel
CXone lit les en-têtes SIP uniquement sur l’INVITE et sa réponse finale. L’agent renvoie donc l’appel : il dit au revoir et raccroche, puis votre script récupère à nouveau l’appelant. Ajoutez ce numéro de transfert (voir
Ajouter le numéro de transfert) :
{"name": "NICE CXone", "action": "return"}NICE ne documente pas la poursuite d’un script après Placecall lorsque l’appel passé se termine. Les intégrations CXone d’autres fournisseurs d’IA signalent plutôt le script via l’API Signal de CXone (POST /interactions/{contactId}/signal) avant de raccrocher ; ThunderPhone ne l’appelle pas. Confirmez avec NICE comment votre script récupère l’appelant, puis récupérez le transfert avec une action API REST :
GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=suivi deContactID.- En-tête
Authorization: Bearer sk_live_…. - Lisez
handoff.summaryethandoff.intentdans la réponse pour effectuer le routage du contact.
Voir Rechercher un appel transféré.
Le tester
Appelez un numéro qui exécute le script, demandez à l'agent de vous passer quelqu'un et vérifiez que le script continue et que l'action d'API REST renvoie le transfert. Si l'appel n'atteint jamais l'agent, vérifiez le numéro envoyé par CXone, que son adresse source 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-call-id et external_call_id doit être égal au ContactID.
Limites
- CXone envoie et lit les en-têtes uniquement sur l'
INVITEet sa réponse finale2xx. Aucun élément duBYEde l'agent n'atteint donc le script. - NICE ne documente pas l'acceptation d'un
REFERprovenant de l'agent. - L'action d'API REST expire après 10 secondes par défaut (90 secondes au maximum) et lit des réponses jusqu'à 32 KB.