Open in
Connecter depuis Amazon Connect
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 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) en plus de l'utilisation à la minute.
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 :
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
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
- Dans la console Amazon Connect, ouvrez Systèmes vocaux externes → Intégrations de transfert vocal, puis choisissez Créer.
- Sélectionnez le type de destination (un SBC) et ajoutez une route sortante
avec l'hôte
sip.thunderphone.com, le port5061et le protocole TLS. Le point de terminaison nécessite TLS ou TCP (port5060) 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. - 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_uridu point de terminaison, par exempleagent-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) :
{"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 :
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é.
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 comprisX-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.