Guide de démarrage — Intégration Alvio

Ce guide vous accompagne étape par étape pour intégrer Alvio à votre système. Après une première tentative d'appel infructueuse, Alvio prend le relais sur WhatsApp pour qualifier le lead et planifier un rendez-vous si pertinent.

Vous n'avez pas de CRM custom ?

Ce guide s'adresse aux entreprises disposant de leur propre système ou d'un CRM personnalisé nécessitant une intégration technique.

Si vous n'avez pas besoin d'une intégration poussée, Alvio peut simplement vous fournir un calendrier partagé auquel vos équipes s'abonnent. Chaque rendez-vous confirmé apparaît automatiquement avec toutes les informations (résumé, transcript, coordonnées). Contactez-nous pour cette option.

Vue d'ensemble du flux

┌─────────────────────────────────────────────────────────────────────────┐
│                         VOTRE SYSTÈME                                   │
│                                                                         │
│   Appel #1 échoué ──────▶ Envoi lead à Alvio (POST webhook)             │
│   (no answer / busy)       { crm_contact_id, phone_number }             │
│                                                                         │
└─────────────────────────────────────┬───────────────────────────────────┘
                                      │
                                      ▼
┌─────────────────────────────────────────────────────────────────────────┐
│                              ALVIO                                      │
│                                                                         │
│   Contact WhatsApp ──────▶ Qualification ──────▶ Prise de RDV           │
│                                                                         │
└─────────────────────────────────────┬───────────────────────────────────┘
                                      │
                                      ▼
┌─────────────────────────────────────────────────────────────────────────┐
│                         VOTRE SYSTÈME                                   │
│                                                                         │
│   Réception statut Alvio ──────▶ Mise à jour CRM                        │
│   (MEETING_BOOKED / NO_WHATSAPP / CONTACT_STOP_REQUESTED)               │
│                                                                         │
└─────────────────────────────────────────────────────────────────────────┘

Checklist d'intégration

Phase 1 — Préparation (Votre équipe)

Phase 2 — Configuration (Alvio + Vous)

Phase 3 — Développement (Votre équipe)

Ce que vous devez préparer

1. Envoi des leads vers Alvio

Votre système doit envoyer un POST HTTP lorsqu'un appel échoue :

{
  "crm_contact_id": "CRM_123456",
  "phone_number": "+33612345678"
}

Champs optionnels recommandés : nom, email, contexte métier, commercial assigné. Voir le guide d'intégration webhook pour le payload complet.

2. Endpoint de callback (réception des statuts)

Vous devez exposer une URL HTTPS pour recevoir les événements Alvio :

POST https://votre-domaine.com/api/alvio/callback

Les notifications de campagne utilisent event_type: "update" et un event_name. Configurez une souscription pour chaque événement utile à votre CRM.

Le guide des souscriptions décrit tous les événements, leur format, les tests et les réessais. Acceptez les valeurs null, vérifiez l'authentification et dédupliquez les notifications avec event_id.

Intégrations existantes : les anciens exemples de ce guide utilisaient status, crm_id, NOT_REACHABLE, OPT_OUT, NO_OUTCOME, FIRST_MESSAGE_DELIVERED, FIRST_MESSAGE_READ ou RESPONSE_RECEIVED. Ils ne décrivent pas le contrat standard actuel des souscriptions. Ces noms ne sont pas des alias automatiques ; conservez tout contrat spécifique déjà en service et validez sa migration avec Alvio.

Ce qu'Alvio fournit

Ce que votre équipe marketing doit préparer

Voir le Guide WhatsApp Business API pour les détails de configuration.

Traiter un retour de campagne

Pour un rendez-vous, lisez event_name: "MEETING_BOOKED", l'identifiant CRM dans external_references.contact_id, puis les horaires dans data.start, data.end et data.timezone. Le JSON complet contient aussi les informations du prospect et de la campagne.

Consultez les exemples complets de rendez-vous, d'escalade et de STOP. Le contrat standard n'inclut pas automatiquement conversation_transcript ou un champ racine ai_summary ; alvio.conversation_url permet d'ouvrir la conversation et data.notes peut contenir des notes pour un rendez-vous.

Prochaines étapes

1. Configurez une campagne de test et récupérez l'URL et le jeton de sa source.
2. Configurez votre destination et vos souscriptions dans Webhooks.
3. Testez les deux sens du flux, y compris la signature et la déduplication, avant la mise en production.

Des questions ? Notre équipe technique est disponible pour vous accompagner à chaque étape.