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 / NOT_REACHABLE / OPT_OUT / NO_OUTCOME) │
│ │
└─────────────────────────────────────────────────────────────────────────┘Checklist d'intégration
Phase 1 — Préparation (Votre équipe)
| # | Tâche | Responsable | Statut |
|---|---|---|---|
| 1.1 | Identifier le déclencheur dans votre système (ex: appel #1 échoué) | Équipe métier | ☐ |
| 1.2 | Définir les champs à transmettre à Alvio (crm_id, phone, nom, etc.) | Équipe métier | ☐ |
| 1.3 | Préparer un endpoint webhook pour recevoir les statuts Alvio | Équipe technique | ☐ |
| 1.4 | Définir les actions CRM pour chaque statut (MEETING_BOOKED, OPT_OUT, etc.) | Équipe métier + tech | ☐ |
Phase 2 — Configuration (Alvio + Vous)
| # | Tâche | Responsable | Statut |
|---|---|---|---|
| 2.1 | Alvio vous fournit l'URL webhook + clé API (test puis production) | Alvio | ☐ |
| 2.2 | Vous communiquez votre URL de callback pour recevoir les statuts | Votre équipe tech | ☐ |
| 2.3 | Configuration du numéro WhatsApp Business | Votre équipe marketing | ☐ |
| 2.4 | Création et validation des templates WhatsApp | Votre équipe marketing | ☐ |
| 2.5 | Connexion du numéro WhatsApp à Alvio | Alvio + Vous | ☐ |
Phase 3 — Développement (Votre équipe)
| # | Tâche | Description | Statut |
|---|---|---|---|
| 3.1 | Envoi des leads | Implémenter l'appel POST vers le webhook Alvio | ☐ |
| 3.2 | Réception des statuts | Implémenter l'endpoint de callback | ☐ |
| 3.3 | Traitement MEETING_BOOKED | Créer le RDV dans le CRM + notifier le commercial | ☐ |
| 3.4 | Traitement NOT_REACHABLE | Marquer le contact (numéro invalide / pas WhatsApp) | ☐ |
| 3.5 | Traitement OPT_OUT | Marquer le contact comme opt-out | ☐ |
| 3.6 | Traitement NO_OUTCOME | Mettre à jour le statut (relance manuelle possible) | ☐ |
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/callbackStatuts possibles :
Statuts de fin :
| Statut | Signification | Action suggérée |
|---|---|---|
MEETING_BOOKED | RDV confirmé | Créer le RDV dans le CRM, notifier le commercial |
NOT_REACHABLE | Numéro invalide ou pas WhatsApp | Marquer le contact, planifier autre canal |
OPT_OUT | Prospect demande l'arrêt | Respecter le choix, ne plus contacter |
NO_OUTCOME | Conversation sans issue claire | Relance manuelle possible, révision dans 24-48h |
Statuts intermédiaires (optionnel) :
Ces statuts permettent un suivi en temps réel de la progression. Leur implémentation est facultative.
| Statut | Signification | Action suggérée |
|---|---|---|
FIRST_MESSAGE_DELIVERED | Premier message envoyé avec succès | Mettre à jour le statut CRM (en cours de contact) |
FIRST_MESSAGE_READ | Le prospect a lu le message | Indicateur d'engagement |
RESPONSE_RECEIVED | Le prospect a répondu | Conversation active |
Ce qu'Alvio fournit
| Élément | Description |
|---|---|
| URL webhook | Endpoint pour envoyer vos leads (test + production) |
| Clé API | Authentification pour sécuriser les échanges |
| Support technique | Accompagnement pendant l'intégration |
| Connexion WhatsApp | Configuration de la liaison avec votre numéro |
Ce que votre équipe marketing doit préparer
| Élément | Description |
|---|---|
| Numéro WhatsApp Business | Numéro dédié à connecter à Alvio |
| Compte Meta Business | Accès au Meta Business Manager |
| Templates WhatsApp | Messages pré-approuvés par Meta (Alvio peut conseiller) |
Voir le Guide WhatsApp Business API pour les détails de configuration.
Exemple de payload de retour
MEETING_BOOKED (rendez-vous confirmé)
{
"crm_id": "CRM_123456",
"status": "MEETING_BOOKED",
"meeting": {
"start": "2026-01-24T14:30:00+01:00",
"timezone": "Europe/Paris"
},
"ai_summary": "Prospect intéressé par l'offre. A posé des questions techniques et demandé le prix. RDV confirmé avec un expert.",
"conversation_transcript": "Voir exemple ci-dessous"
}NOT_REACHABLE
{
"crm_id": "CRM_123456",
"status": "NOT_REACHABLE",
"details": { "reason": "NO_WHATSAPP" }
}OPT_OUT
{
"crm_id": "CRM_123456",
"status": "OPT_OUT",
"details": { "reason": "STOP" }
}NO_OUTCOME
{
"crm_id": "CRM_123456",
"status": "NO_OUTCOME",
"ai_summary": "Conversation initiée. Prospect a répondu partiellement puis silence.",
"conversation_transcript": "..."
}Statuts intermédiaires (optionnel)
{
"crm_id": "CRM_123456",
"status": "FIRST_MESSAGE_DELIVERED"
}{
"crm_id": "CRM_123456",
"status": "FIRST_MESSAGE_READ"
}{
"crm_id": "CRM_123456",
"status": "RESPONSE_RECEIVED"
}Exemple de conversation_transcript
Le champ conversation_transcript contient l'historique complet de la conversation, anonymisé. Voici un exemple réel :
🗨️ RÉSUMÉ DE CONVERSATION
=====================================
📞 Contact: Prospect A12
🏢 Entreprise: Non renseignée
📱 Téléphone: +33 6 ** ** ** 04
📞 Numéro société: +33 6 ** ** ** 90
📊 Statut actuel: resolved
🏷️ Étape Kanban: responded
📅 Début: 08/10/2025 09:31
⏰ Dernière activité: 13/10/2025 13:36
-------------------------------------
📋 HISTORIQUE DES MESSAGES:
8 octobre 2025 à 09:31 - 💬 Agent: Bonjour, je suis [Prénom] de [Société]. Merci pour votre demande, est-ce que vous connaissez ce produit ?
8 octobre 2025 à 09:31 - 👤 Client: Non
8 octobre 2025 à 09:32 - 💬 Agent: D'accord ! [Description produit et bénéfices]. Utilisez-vous un produit similaire ?
8 octobre 2025 à 09:33 - 👤 Client: Non
8 octobre 2025 à 09:33 - 💬 Agent: Merci pour votre réponse. Quel est votre contexte actuel ?
8 octobre 2025 à 09:34 - 👤 Client: Entre 6,5 et 7
8 octobre 2025 à 09:35 - 💬 Agent: D'accord, c'est pertinent. De combien pensez-vous avoir besoin ?
8 octobre 2025 à 09:40 - 👤 Client: Et le prix
8 octobre 2025 à 09:41 - 💬 Agent: Je vais vous proposer un appel avec l'un de nos experts pour discuter en détail du prix. Quand seriez-vous disponible ?
8 octobre 2025 à 09:41 - 👤 Client: Début après-midi vers 14h30
8 octobre 2025 à 09:43 - 💬 Agent: Pour quel jour souhaitez-vous organiser l'appel à 14h30 ?
8 octobre 2025 à 09:44 - 👤 Client: Demain
8 octobre 2025 à 09:45 - 💬 Agent: C'est réservé ! Vous avez un appel avec un expert demain à 14h30.
8 octobre 2025 à 11:58 - 👤 Client: Lundi 13
8 octobre 2025 à 12:00 - 💬 Agent: C'est réservé pour lundi 13/10 à 14h30. Un expert vous appellera.
13 octobre 2025 à 13:30 - 💬 Agent: Bonjour, juste un petit rappel : notre appel est prévu dans environ une heure.
13 octobre 2025 à 13:31 - 👤 Client: Pas possible
13 octobre 2025 à 13:32 - 💬 Agent: Je vous propose un nouveau créneau. Êtes-vous dispo mardi ou mercredi ?
13 octobre 2025 à 13:32 - 👤 Client: Mercredi
13 octobre 2025 à 13:33 - 💬 Agent: D'accord pour mercredi. Préférez-vous 8h30-9h ou 14h-14h30 ?
13 octobre 2025 à 13:33 - 👤 Client: 14h
13 octobre 2025 à 13:36 - 💬 Agent: Merci ! Votre appel est confirmé pour mercredi à 14h.
=====================================
Conversation mise à jour automatiquement par Alvio.Prochaines étapes
- Prenez contact avec Alvio pour recevoir vos credentials de test
- Partagez votre URL de callback pour que nous puissions configurer les retours
- Commencez par la Phase 3 — développement des endpoints
Des questions ? Notre équipe technique est disponible pour vous accompagner à chaque étape.