Agents

Créer

POST /agents · permission agents:write · idempotent

BASH
curl -X POST https://api.click2call.app/v1/agents \
  -H "Authorization: Bearer $CLICK2CALL_API_KEY" \
  -H "Idempotency-Key: agent-alice" \
  -H "Content-Type: application/json" \
  -d '{"name":"Alice","phone_number":"+33612345678","priority":10}'

La réponse masque le numéro :

JSON
{"data":{"id":"01K...","name":"Alice","phone_masked":"+33 • •• •• 56 78","verified":false,"active":false,"priority":10}}

Vérifier

  1. POST /agents/{id}/verifications déclenche un appel vocal et renvoie un état ainsi que l'expiration du code.
  2. L'agent saisit pendant l'appel le code temporaire visible dans le tableau de bord.
  3. GET /agents/{id} passe verified à true.

Le code expire, a un nombre d'essais limité et n'est jamais renvoyé par les endpoints de liste.

Administrer

  • GET /agents
  • GET /agents/{id}
  • PATCH /agents/{id} pour le nom, la priorité, la disponibilité ou l'activation
  • DELETE /agents/{id} · réponse 204

Un changement de numéro remet verified et active à false.