Webhooks

Les webhooks vous notifient en temps réel des événements de vos envois. Dès qu'un événement survient, Conexteo envoie une requête HTTP à l'URL que vous avez déclarée pour le type concerné.

Les trois types

ack_sms : accusés de réception SMS (délivré, échec).

reply : réponses entrantes des destinataires, SMS et RCS (y compris les clics sur les suggestions RCS).

ack_rcs : statuts RCS (délivré, lu, échec, repli SMS). Disponible uniquement en mode signé.

Mode signé ou non signé

Non signé : envoi simple, sans garantie de remise (voir réessais ci-dessous).

Signé (recommandé) : chaque requête porte une signature HMAC à vérifier, et bénéficie des réessais. C'est le mode requis pour ack_rcs.

Livraison et réessais

Succès ou échec d'une tentative
Une réponse HTTP 2xx de votre serveur = livré. Tout autre code, un timeout ou une erreur réseau = tentative en échec.

Réessais (webhooks signés uniquement)
Un webhook non signé est envoyé une seule fois : s'il échoue, il n'est pas réessayé. Un webhook signé est réessayé jusqu'à 8 tentatives au total, avec un délai croissant entre chaque :

Après l'échec n°	Prochaine tentative dans
1	30 secondes
2	2 minutes
3	10 minutes
4	30 minutes
5	1 heure
6	4 heures
7	12 heures

Soit une fenêtre de réessai d'environ 18 heures. Passé la 8e tentative sans succès, la livraison est abandonnée (statut failed).

Idempotence
Le header X-Conexteo-Webhook-Id reste identique entre toutes les tentatives d'un même événement. Traitez chaque identifiant une seule fois : c'est votre garantie contre les doublons.

Suivi
Consultez l'état de vos livraisons via GET /webhooks/deliveries (statuts : pending, delivered, failed, cancelled).

Les trois types#

Mode signé ou non signé#

Livraison et réessais#

Les trois types

Mode signé ou non signé

Livraison et réessais