---
title: "Se connecter depuis NICE CXone"
description: "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'agent lorsque le script se poursuit."
---

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](/fr/guides/api-keys) 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](/fr/guides/sip-addresses)) :

```bash
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 `/16` ou plus spécifique (IPv6 `/48` ou 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 renvoie `409`.

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** :

1. Ajoutez une action **Sipputheader** avec l’en-tête `X-Call-ID` et la valeur de `ContactID`. CXone n’envoie aucun en-tête d’identifiant d’appel propre ; ThunderPhone stocke celui-ci comme `external_call_id` de l’appel.
2. Ajoutez une action **Sipputheader** pour chaque autre valeur que l’agent doit connaître, par exemple `X-Skill` défini sur `support`. Elle atteint le prompt sous la forme `{{sip_x_skill}}`. Sipputheader accepte `User-to-User`, tout en-tête `X-` et la plupart des en-têtes `P-` ; 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](/fr/guides/contact-centers/overview)) :

```json
{"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 de `ContactID`.
- En-tête `Authorization: Bearer sk_live_…`.
- Lisez `handoff.summary` et `handoff.intent` dans la réponse pour effectuer le routage du contact.

Voir [Rechercher un appel transféré](/api-reference/calls#look-up-a-handed-off-call).

## 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'`INVITE` et sa réponse finale `2xx`. Aucun élément du `BYE` de l'agent n'atteint donc le script.
- NICE ne documente pas l'acceptation d'un `REFER` provenant 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.
