Webhooks

AI4CALL peut appeler des URL configurées pour les résultats liés aux appels. La configuration accepte des URL http:// ou https:// ; en production, utilisez HTTPS, validez le JSON attendu et corrélez les événements avec la requête ou l’appel enregistré par votre application.

Callback de résultat outbound

Définissez callResultUrl lorsque vous lancez un appel outbound. AI4CALL envoie :

{
  "internal_id": "<YOUR_CORRELATION_ID>",
  "dialstatus": "ANSWER",
  "duration": 42
}

La callback communique uniquement le résultat outbound ; elle ne contient pas la transcription de la conversation.

Conversation et post-call

Configurez l’endpoint de fin de conversation avec PATCH /assistants/{assistantId}/runtime/hangup/conversation-webhook :

{
  "enabled": true,
  "url": "https://example.com/hooks/ai4call",
  "authName": "crm-bearer"
}

authName est le nom d’une authentification déjà enregistrée pour le client. Les identifiants correspondants sont résolus côté serveur et ne transitent pas dans la requête. Envoyez authName: null pour envoyer sans authentification ; désactivez l’intégration avec enabled: false.

Configurez l’extraction de données structurées avec PATCH /assistants/{assistantId}/runtime/hangup/schema :

{
  "hangupUrl": "https://example.com/hooks/extracted-data",
  "schema": [{
    "name": "customerIntent",
    "type": "string",
    "description": "Motif principal de l'appel",
    "required": true
  }]
}

Les types de propriété du schéma sont string, number, boolean, enum et object. Configurez MCP post-call séparément via /runtime/postcall/mcp-config.

Ne supposez pas l’envoi d’une signature HMAC : la signature webhook ne fait pas partie du contrat actuel. Pour les payloads de configuration exacts, consultez la Référence API.