aethexDocs
Tableau de bord

Numéros de téléphone

Enregistrez des numéros de téléphone pour que vos agents puissent recevoir des appels entrants et passer des appels sortants.

À quoi servent les numéros de téléphone

Un numéro de téléphone enregistré associe un vrai numéro PSTN à un agent Aethex. Une fois enregistré, les appels entrants vers ce numéro sont acheminés directement vers l'agent ; les appels sortants de l'agent passent par l'opérateur de ce numéro.

Enregistrer un numéro Twilio

Fournissez le numéro au format E.164, votre ID de compte Twilio (depuis le tableau de bord Aethex sous Comptes Twilio) et un nom convivial optionnel. Aethex configure automatiquement le webhook Twilio pour que les appels entrants soient acheminés vers votre agent.

Enregistrer un numéro Twilio
bash
curl -X POST https://api.aethexai.com/api/v1/phone-numbers/twilio/register \
  -H "X-API-Key: $AETHEX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_number": "+15551234567",
    "twilio_account_id": "<TWILIO_ACCOUNT_UUID>",
    "agent_id": "<your-agent-id>",
    "friendly_name": "Support line"
  }'

Enregistrer un numéro SIP

Vous apportez votre propre opérateur ou PBX ? Créez un trunk entrant via l'API SIP Trunks et rattachez ici un numéro avec le trunk_id. Aethex achemine les appels entrants de ce numéro vers votre agent. Pour les trunks sortants uniquement, /sip-trunks/onboard enregistre les numéros automatiquement — cette étape n'est pas nécessaire.

Enregistrer un numéro SIP
bash
curl -X POST https://api.aethexai.com/api/v1/phone-numbers/sip/register \
  -H "X-API-Key: $AETHEX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_number": "+15551234567",
    "trunk_id": "<YOUR_TRUNK_UUID>",
    "agent_id": "<your-agent-id>"
  }'

Appels sortants

Pour passer un appel sortant, déclenchez-le via POST /calls/trigger avec from_number défini sur le numéro enregistré et to_number sur la destination. L'agent répond dès que l'appelé décroche.Pour les campagnes d'appels sortants en masse, utilisez POST /calls/batch pour planifier une liste d'appels.

Acheminement entrant

L'acheminement entrant est automatique une fois le numéro enregistré et lié à un agent. Pour lier un numéro à un agent spécifique, définissez agent_id lors de l'enregistrement du numéro de téléphone. Mettez à jour l'acheminement à tout moment avec PATCH /phone-numbers/{id}.

Vérifier l'enregistrement

Après l'enregistrement, listez vos numéros de téléphone pour confirmer que le numéro apparaît avec status: active.

Vérifier l'enregistrement
bash
curl https://api.aethexai.com/api/v1/phone-numbers \
  -H "X-API-Key: $AETHEX_API_KEY"

Cycle de vie

Pour mettre à jour l'acheminement (changer l'agent vers lequel un numéro pointe), utilisez PATCH /phone-numbers/{id}. Pour libérer un numéro d'Aethex (sans l'annuler chez Twilio ou votre opérateur), utilisez DELETE /phone-numbers/{id}.

Suivant

Une fois que vous avez un numéro, déclenchez votre premier appel sortant : consultez la référence de l'API Appels pour le contrat complet de POST /calls/trigger. Pour qu'un numéro envoie ou réponde aux SMS, voir SMS.