SIP trunking

Vue d'ensemble

Un trunk SIP connecte votre opérateur de téléphonie ou votre PBX directement à Aethex, afin que les appels entrants et sortants passent par vos agents vocaux via SIP plutôt que via un numéro géré. Aethex termine le SIP sur une edge dédiée et accessible mondialement, puis achemine l'appel dans le même pipeline d'agents que WebRTC et Twilio.Un appel peut atteindre Aethex de deux manières :Votre opérateur nous livre les appels. Votre opérateur envoie les appels entrants à l'edge SIP d'Aethex. C'est la configuration la plus courante et elle fonctionne avec la plupart des fournisseurs de trunk SIP et des PBX.Aethex s'enregistre auprès de votre opérateur. Pour les trunks qui ne livrent qu'à un endpoint enregistré (trunks nécessitant un REGISTER), Aethex s'enregistre auprès de votre opérateur en votre nom et relaie les appels entrants. Utilisé par certains fournisseurs de PBX hébergés et de softphones.

L'endpoint SIP d'Aethex

Pointez votre opérateur ou votre trunk SIP vers l'edge SIP d'Aethex. Le nom d'hôte résout vers des adresses IP Elastic stables, de sorte que les opérateurs qui s'authentifient par IP source peuvent autoriser ces adresses directement.Le SIP n'est pas servi via un CDN. Connectez-vous directement au nom d'hôte ou aux adresses IP ci-dessous sur les ports SIP.

Hostname     sip.aethexai.com
Edge IPs     13.63.135.167, 51.21.123.34
Signaling    5060/udp, 5060/tcp
Media        10000-60000/udp  (RTP/SRTP)

Sortant : appeler via votre opérateur

Pour les appels sortants BYO carrier, créez un trunk SIP sortant et enregistrez les caller IDs qu'Aethex peut utiliser. L'endpoint one-shot `POST /sip-trunks/onboard` est le chemin par défaut : il crée le trunk, crée les lignes de numéros de téléphone et peut définir le trunk comme défaut du tenant en une seule transaction.

1. 01

   Onboarder le trunk sortant

   Envoyez l'hôte SIP de votre opérateur, le mode d'authentification, les identifiants si votre opérateur utilise l'authentification digest, et les caller IDs E.164 que vous possédez. Définissez set_as_tenant_default lorsque ce trunk doit être le fallback des appels sortants.

   Corps de requête POST /sip-trunks/onboard

   bash

   curl -X POST https://api.aethexai.com/api/v1/sip-trunks/onboard \
     -H "X-API-Key: $AETHEX_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "name": "Production carrier",
       "outbound_address": "sip.carrier.example.com:5060",
       "numbers": ["+14155551234"],
       "auth_mode": "digest",
       "auth_username": "aethex_outbound",
       "auth_password": "<from your carrier>",
       "outbound_dial_format": "e164",
       "set_as_tenant_default": true
     }'

2. 02

   Appeler depuis un numéro SIP enregistré

   Après le retour de l'onboarding, passez l'un des numéros SIP enregistrés comme from_number sur POST /calls/trigger. Aethex résout le numéro vers son trunk et envoie l'INVITE SIP via votre opérateur.

   Corps POST /calls/trigger

   bash

   curl -X POST https://api.aethexai.com/api/v1/calls/trigger \
     -H "X-API-Key: $AETHEX_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "agent_id": "8a1b2c3d-4e5f-6789-abcd-ef0123456789",
       "to_number": "+14155550199",
       "from_number": "+14155551234"
     }'

Adaptez le format de numérotation de votre opérateur

Les opérateurs ne s'accordent pas sur la façon dont la destination doit apparaître dans l'INVITE SIP sortant. Définissez outbound_dial_format sur le trunk sortant pour correspondre à ce qu'attend votre opérateur : Aethex l'applique à chaque appel de ce trunk, juste avant la numérotation. Votre requête API, les vérifications de propriété du caller ID et les listes d'autorisation anti-fraude restent toujours en E.164 ; cela ne change que ce que votre opérateur voit sur le réseau.

FORMAT     SENT TO CARRIER     USE WHEN
e164       +15551234567        default; carrier accepts +E.164
digits     15551234567         carrier rejects the leading +
national   05551234567         carrier needs national format (1 country)

Entrant : votre opérateur livre à Aethex

Configurez votre opérateur pour envoyer les appels entrants de votre numéro vers sip.aethexai.com (port 5060). Enregistrez ensuite le trunk auprès d'Aethex afin que l'edge authentifie votre opérateur et achemine l'appel. La création d'un trunk entrant provisionne automatiquement la règle d'acheminement qui remet l'appel à votre agent.Indiquez les numéros que l'opérateur livrera dans numbers, et les adresses IP source de l'opérateur dans allowed_addresses (ou définissez auth_username et auth_password pour l'authentification digest). Enfin, associez chaque numéro à un agent. Voir Numéros de téléphone.

curl -X POST https://api.aethexai.com/api/v1/sip-trunks \
  -H "X-API-Key: $AETHEX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Acme inbound",
    "type": "inbound",
    "numbers": ["+15551234567"],
    "allowed_addresses": ["198.51.100.10"]
  }'

Autorisation des IP de l'opérateur

La périphérie SIP de la plateforme n'accepte la signalisation que depuis des adresses d'opérateur connues. Les allowed_addresses définies sur un trunk entrant pilotent automatiquement les deux niveaux : la périphérie SIP d'Aethex les utilise pour authentifier les INVITE de l'opérateur et ouvre son pare-feu aux mêmes adresses, sans ticket support. Fournissez jusqu'à 10 adresses IPv4 publiques ou blocs CIDR (/24–/32) par trunk ; chaque compte dispose d'un budget partagé entre ses trunks ; contactez-nous pour l'augmenter. Les changements s'appliquent généralement en quelques secondes.

Entrant : Aethex s'enregistre auprès de votre opérateur

Certains opérateurs ne livrent les appels entrants qu'à un endpoint SIP qui s'est enregistré auprès d'eux (un trunk nécessitant un REGISTER). Aethex exploite un pont d'enregistrement qui s'enregistre auprès de votre opérateur en votre nom et relaie l'appel entrant dans votre pipeline d'agents, sans aucun changement dans la manière dont vos agents sont construits.C'est en libre-service : créez un trunk entrant avec auth_mode défini sur register, en fournissant l'adresse du registrar de l'opérateur (outbound_address), le nom d'utilisateur et le mot de passe SIP (auth_username / auth_password), votre numéro, et l'IP de signalisation de l'opérateur dans allowed_addresses. La plateforme maintient l'enregistrement et ouvre automatiquement son pare-feu de périphérie à cet opérateur. Transmettez le nom d'utilisateur digest exactement tel que l'opérateur l'a émis ; certains opérateurs exigent le nom d'utilisateur de connexion en minuscules seul (pas user@domaine), et la casse compte. Le mot de passe de votre opérateur est stocké chiffré et n'est jamais retourné.

TLS et chiffrement du média

Le média peut être négocié en SRTP. Définissez le chiffrement du média du trunk sur allow (par défaut) ou require pour imposer le SRTP. La signalisation chiffrée (SIPS via TLS, port 5061) n'est pas encore activée sur l'edge public ; elle est provisionnée par déploiement lors de l'onboarding. Contactez Aethex si votre opérateur exige une signalisation TLS.

Autorisation d'adresses IP

Si votre opérateur exige que vous autorisiez les adresses depuis lesquelles Aethex envoie et vers lesquelles il livre, utilisez les adresses IP de l'edge de production ci-dessous. Ce sont des adresses IP Elastic stables qui ne changent pas lorsque les instances sont remplacées.

13.63.135.167
51.21.123.34

Étapes suivantes

Associez vos numéros entrants à des agents dans Numéros de téléphone, construisez l'agent qui répond dans Agents, et consultez Webhooks pour recevoir les événements d'appel.