---
title: "Connecter depuis Amazon Connect"
description: "Envoyez les appels Amazon Connect à un agent ThunderPhone via SIP avec l’identifiant de contact et l’UUI, puis reprenez votre flux avec le transfert de l’agent."
---

Votre flux Amazon Connect envoie l'appelant à l'agent avec l'id de contact et
tout UUI que vous définissez. Lorsque l'agent a terminé, il raccroche, votre flux
se poursuit et une fonction Lambda récupère le transfert par id de contact.

## Avant de commencer

- Un agent ThunderPhone et une [clé API](/fr/guides/api-keys) d'organisation.
- Le connecteur **Transfert vocal externe** d'Amazon Connect. Demandez d'abord
  l'augmentation du quota « Connecteurs de transfert vocal externe par compte » :
  le menu reste masqué jusqu'à son approbation par AWS. AWS facture chaque
  connecteur à la journée
  ([$100 par jour depuis le 21 juillet 2025](https://aws.amazon.com/about-aws/whats-new/2025/07/amazon-connect-announces-per-day/))
  en plus de l'utilisation à la minute.

<Warning>
  Le guide d'administration actuel d'AWS ne contient plus de pages sur le
  transfert vocal externe. Avant de vous appuyer dessus, confirmez auprès d'AWS
  que le connecteur est disponible pour votre instance et votre région.
</Warning>

## 1. Créer le point de terminaison SIP

Le connecteur ne documente pas l'authentification SIP Digest. Créez donc un
point de terminaison qui accepte les appels par adresse source :

```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": "Amazon Connect",
    "auth": "ip_allowlist",
    "allowed_source_cidrs": ["CONNECT_SIGNALLING_RANGE_1", "CONNECT_SIGNALLING_RANGE_2"]
  }'
```

Récupérez auprès d'AWS les plages de signalisation SIP du connecteur pour votre
région. Chacune doit être une plage IPv4 publique de `/16` ou plus restreinte
(IPv6 `/48` ou plus restreinte). Consultez
[les plateformes qui s'authentifient par IP source](/fr/guides/sip-addresses)
pour connaître les règles et le risque d'une adresse partagée par tous les
clients de la plateforme. Conservez le `sip_uri` de la réponse, par exemple
`sip:agent-12-jhxmginwjx@sip.thunderphone.com`.

## 2. Envoyer des appels avec du contexte

1. Dans la console Amazon Connect, ouvrez **Systèmes vocaux externes → Intégrations
   de transfert vocal**, puis choisissez **Créer**.
2. Sélectionnez le type de destination (un SBC) et ajoutez une route sortante
   avec l'hôte `sip.thunderphone.com`, le port `5061` et le protocole TLS. Le
   point de terminaison nécessite TLS ou TCP (port `5060`) et refuse UDP. AWS
   ne documente pas les protocoles proposés par le connecteur. Confirmez donc
   auprès d'AWS qu'il peut utiliser l'un d'eux.
3. Dans votre flux, ajoutez un bloc **Transférer vers un numéro de téléphone**
   avec **Transférer vers** défini sur **Système vocal externe**, puis définissez :
   - **ARN de destination :** le connecteur.
   - **Vers l'utilisateur :** la partie utilisateur du `sip_uri` du point de
     terminaison, par exemple `agent-12-jhxmginwjx`.
   - **UUI** (facultatif) : le contexte destiné à l'agent. Connect l'envoie encodé
     en hexadécimal.
   - **Reprendre le flux après déconnexion :** Oui, afin que le flux se poursuive
     lorsque l'agent raccroche.

Connect envoie l'id de contact dans `X-Amzn-ConnectContactId`. ThunderPhone le
stocke comme `external_call_id` de l'appel, ce qui permet à votre flux de
retrouver l'appel ultérieurement. L'UUI arrive dans le prompt sous la forme
`{{sip_uui}}`. Les intégrations tierces documentent l'en-tête d'id de contact ;
la documentation d'AWS ne le fait pas. Vérifiez-le donc lors de votre premier
appel de test.

## 3. Récupérer l'appel

AWS ne documente aucun moyen pour Connect de lire les en-têtes du `BYE` ni d'accepter un
`REFER` de l'agent. L'agent renvoie donc l'appel : il dit au revoir et
raccroche, puis votre flux reprend après le bloc de transfert. Ajoutez ce numéro de transfert (voir [Ajouter le numéro de transfert](/fr/guides/contact-centers/overview)) :

```json
{"name": "Amazon Connect", "action": "return"}
```

Récupérez ensuite le transfert avec un bloc **Invoquer une fonction AWS Lambda** après le
transfert. La fonction Lambda recherche l'appel par identifiant de contact :

```python
import json
import os
import urllib.error
import urllib.parse
import urllib.request


def lambda_handler(event, context):
    contact_id = event["Details"]["ContactData"]["ContactId"]
    url = "https://api.thunderphone.com/v1/calls/handoff?" + urllib.parse.urlencode(
        {"external_call_id": contact_id}
    )
    request = urllib.request.Request(
        url, headers={"Authorization": "Bearer " + os.environ["THUNDERPHONE_API_KEY"]}
    )
    try:
        with urllib.request.urlopen(request, timeout=5) as response:
            call = json.load(response)
    except (urllib.error.URLError, TimeoutError):
        return {"found": "false"}
    handoff = call.get("handoff") or {}
    return {
        "found": "true",
        "intent": handoff.get("intent") or "",
        "summary": handoff.get("summary") or "",
    }
```

Le bloc renvoie une map plate, afin que le flux puisse créer une branche selon `intent` ou définir
`summary` comme attribut de contact pour la personne qui prend l'appel. Exécutez le
bloc de manière synchrone (jusqu'à 8 secondes) et stockez la clé API de manière chiffrée, par
exemple dans AWS Secrets Manager. Les champs de réponse sont décrits dans
[Rechercher un appel transféré](/api-reference/calls#look-up-a-handed-off-call).

## Le tester

Appelez un numéro de votre instance Connect qui atteint le bloc de transfert, demandez à
l'agent de parler à une personne, puis vérifiez que le flux reprend. Ouvrez ensuite l'appel avec
`GET /v1/calls/{call_id}` : `sip_headers` doit contenir
`x-amzn-connectcontactid`, et `external_call_id` doit être égal au `ContactId`
reçu par votre fonction Lambda. Si le transfert échoue avec SIP `404`, ThunderPhone n'a pas
trouvé la partie utilisateur du point de terminaison : elle doit figurer à la fois dans l'URI de requête et dans l'en-tête
`To`.

## Limites

- AWS ne documente aucun moyen de lire les en-têtes du `BYE`, y compris
  `X-TP-Handoff-Id`, donc l'identifiant de contact est le seul lien vers l'appel.
- AWS ne documente pas de longueur UUI maximale pour le connecteur.
- Un bloc Lambda synchrone expire après 8 secondes.
