Développeurs

Des webhooks en temps réel pour chaque appel.

Envoyez les résumés d'appels, les changements de contacts et les événements de formulaires directement dans vos propres systèmes. Enregistrez un point de terminaison et votre Secrétaire IA s'occupe du reste.

JSON sur HTTPS · Jeton Bearer

Webhooks

Comment ça marche

Enregistrez un point de terminaison HTTPS avec un secret. Quand quelque chose se produit, nous envoyons un POST avec un événement JSON à votre point de terminaison — vérifiez le secret, traitez l'événement et renvoyez 2xx.

POST https://your-app.com/yousquared/webhook

{
  "event_type": "inbound_end_of_call",
  "payload": {
    "caller_phone_number": "+14155550123",
    "yousquared_conversation_id": "conv_8f2a…",
    "started_at": "2026-06-16T15:04:05Z",
    "duration_seconds": 72,
    "is_urgent": true,
    "is_empty": false,
    "is_spam": false,
    "conversation_type": "inbound",
    "super_short_report": "Nouveau patient, rendez-vous jeudi 15 h 30.",
    "short_report": "L'appelant souhaitait un rendez-vous cette semaine…"
  }
}

Vérifier et accuser réception — Node.js

app.post("/yousquared/webhook", (req, res) => {
  // Vérifiez le jeton Bearer à chaque requête.
  const auth = req.header("Authorization");
  if (auth !== `Bearer ${process.env.YOUSQUARED_WEBHOOK_SECRET}`) {
    return res.sendStatus(401);
  }

  const { event_type, payload } = req.body;
  handleEvent(event_type, payload);

  // Répondez 2xx pour accuser réception. Le corps est ignoré.
  res.sendStatus(200);
});

Événements

Ce que vous pouvez écouter

Chaque événement arrive sous la forme { event_type, payload }. Les champs du payload varient selon l'événement.

inbound_end_of_call
Un appel s'est terminé. Comprend le résumé, l'urgence et les métadonnées de l'appel.
contact_updated
Les renseignements d'un contact ont changé.
contact_exists
Un appelant entrant a été associé à un contact existant.
lead_update
Le statut ou les renseignements d'un client potentiel ont changé.
form_sent
Un formulaire a été envoyé à un contact.
form_opened
Un contact a ouvert un formulaire que vous avez envoyé.
form_submitted
Un contact a soumis un formulaire.
form_signed
Un contact a signé un formulaire.

Livraison

Règles de livraison

Quelques points à prévoir pour qu'aucun événement ne passe entre les mailles.

Répondez avec n'importe quel statut 2xx pour accuser réception — le corps de la réponse est ignoré.
Chaque requête transporte votre secret dans l'en-tête Authorization: Bearer <secret>. Vérifiez-le.
Les réponses non-2xx ne déclenchent aucune nouvelle tentative, alors gardez votre point de terminaison hautement disponible.
Les requêtes expirent après 10 secondes.

Entreprise

Une intégration plus poussée avec votre DME, votre PMS ou votre CRM

Au-delà des webhooks, nous travaillons avec les équipes sur des intégrations directes — importation et exportation sécurisées de données et connexions à vos systèmes cliniques et d'affaires. Dites-nous ce que vous utilisez et nous en définirons la portée avec vous.

Parlez-nous