ThunderPhone v3 est disponible.En libre-service, à partir de 2 ¢/min.Découvrir l’annonce

Contact centers

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

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

{"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 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.