API : invitations à usage unique

Créer des liens personnels depuis un autre outil.

À quoi ça sert

Envoyer un sondage de satisfaction après chaque dossier, achat ou rendez-vous.

Prérequis et forfait

Forfaits Pro et Premium (send_email aussi).

Étapes

1. POST r=invites&id=<sondage> avec {"name":"…","email":"…","ref":"rdv-4521","send_email":true}.
2. La réponse contient invite.url : le lien personnel et invite.id.
3. GET r=invites&id=<sondage> liste les invitations et leur statut (created, sent, answered).
4. Quand la personne répond, le webhook response.created contient le même ref.

Résultat attendu

Le répondant reçoit son lien (par courriel ou par votre outil) et ne peut répondre qu’une fois.

Astuces

• « ref » (80 caractères) sert à relier la réponse à votre dossier.
• Dans un sondage anonyme, la réponse ne contient pas le courriel ni le nom : seul ref est repris.

Problèmes fréquents

207 avec « warning ».

L’invitation est créée mais le courriel n’a pas pu partir : utilisez invite.url.

422 « Un courriel est requis… ».

send_email demande un courriel.

Pages concernées

Intégrations

Ces pages demandent d’être connecté.

Articles liés