aethexDocs
Telnyx logo
Téléphonie

Telnyx

Utilisez votre propre numéro Telnyx. Ajoutez votre clé API et Aethex provisionne un trunk SIP et rattache le numéro à un agent, sans configuration dans le portail opérateur.

Comment ça marche

Vous fournissez une clé API Telnyx à Aethex une seule fois. Quand vous connectez un numéro, Aethex pilote l'API Telnyx pour vous : il crée une connexion SIP pointant vers l'edge Aethex, y attribue votre numéro et crée le trunk SIP correspondant. Les appels entrants vers ce numéro atteignent votre agent, et les appels sortants passent par votre propre compte Telnyx. Vous n'ouvrez jamais le portail Telnyx et ne copiez aucun identifiant SIP à la main.

Connecter un numéro

Liez votre compte avec une clé API, puis connectez un numéro et rattachez-le à un agent. La clé est validée auprès de Telnyx avant d'être stockée, chiffrée au repos et jamais renvoyée dans une réponse.

Lier, puis connecter
bash
# 1. Link your Telnyx account (validated, then stored encrypted)
curl -X POST https://api.aethexai.com/api/v1/integrations/telephony/carriers \
  -H "X-API-Key: $AETHEX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "provider": "telnyx", "api_key": "KEY0123...your-telnyx-api-key" }'

# 2. Connect a number and point it at an agent
curl -X POST https://api.aethexai.com/api/v1/integrations/telephony/carriers/$ID/connect \
  -H "X-API-Key: $AETHEX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "phone_number": "+14155550100", "agent_id": "<your-agent-id>" }'

Ce que vous obtenez

Un trunk SIP fonctionnel en mode register, votre numéro routé vers l'agent choisi pour les appels entrants, et les appels sortants via votre compte Telnyx. Si une étape échoue, Aethex annule les objets créés côté Telnyx pour qu'une nouvelle tentative reparte sur une base propre.

Remarque
Un seul compte Telnyx actif par espace de travail. Libérez le compte actuel avant d'en lier un autre.

Référence de l'API

Pour tous les champs de requête et de réponse, consultez la référence de l'API Carrier Accounts.