Appels WhatsApp

Passer un appel dans WhatsApp, sans que le client ait à composer un numéro.

La permission d'abord

Tu ne peux pas appeler un client qui ne t'y a pas autorisé. C'est une exigence de Meta, et le premier obstacle de toute intégration d'appel.

GET  /whatsapp/calls/permissions/{phone}
POST /whatsapp/calls/permissions

Interroge l'état avant chaque tentative : une permission a une durée de validité, elle n'est pas acquise une fois pour toutes. La demande part sous forme de message, auquel le client répond par oui ou non.

Le bouton d'appel

POST /whatsapp/calls/button

Envoie un message porteur d'un bouton d'appel : c'est le client qui déclenche, ce qui évite la question de la permission. Souvent le chemin le plus simple pour du support.

POST /whatsapp/calls/deeplink

Renvoie un lien à poser dans un courriel, une facture ou une page web, qui ouvre WhatsApp sur un appel vers ton numéro.

Établir un appel

POST /whatsapp/calls/connect
POST /whatsapp/calls/{id}/pre-accept
POST /whatsapp/calls/{id}/accept
POST /whatsapp/calls/{id}/reject
POST /whatsapp/calls/{id}/terminate
GET  /whatsapp/calls/{id}/media

Ces routes échangent des offres et réponses SDP : elles ne servent qu'à une intégration qui porte elle-même la couche média WebRTC. Si tu veux simplement recevoir des appels, le bouton suffit.

pre-accept avant accept réduit le blanc au décroché : la négociation média se fait pendant que ça sonne encore.

Suivi

GET   /whatsapp/calls/settings
PATCH /whatsapp/calls/settings
GET   /whatsapp/calls/health
GET   /whatsapp/calls/analytics

health renseigne l'état du canal d'appel côté Meta. À consulter en premier quand des appels échouent sans motif clair.