Getting Started — Alvio Integration

This guide walks you step by step through integrating Alvio with your system. After a first failed call attempt, Alvio takes over on WhatsApp to qualify the lead and schedule an appointment when relevant.

Don't have a custom CRM?

This guide is for companies with their own system or a custom CRM that requires technical integration.

If you don't need deep integration, Alvio can simply provide a shared calendar that your teams subscribe to. Each confirmed appointment appears automatically with all details (summary, transcript, contact info). Contact us for this option.

Flow overview

┌─────────────────────────────────────────────────────────────────────────┐
│                         YOUR SYSTEM                                     │
│                                                                         │
│   Call #1 failed ──────▶ Send lead to Alvio (POST webhook)              │
│   (no answer / busy)     { crm_contact_id, phone_number }              │
│                                                                         │
└─────────────────────────────────────┬───────────────────────────────────┘
                                      │
                                      ▼
┌─────────────────────────────────────────────────────────────────────────┐
│                              ALVIO                                      │
│                                                                         │
│   WhatsApp contact ──────▶ Qualification ──────▶ Booking               │
│                                                                         │
└─────────────────────────────────────┬───────────────────────────────────┘
                                      │
                                      ▼
┌─────────────────────────────────────────────────────────────────────────┐
│                         YOUR SYSTEM                                     │
│                                                                         │
│   Receive Alvio status ──────▶ Update CRM                               │
│   (MEETING_BOOKED / NO_WHATSAPP / CONTACT_STOP_REQUESTED)               │
│                                                                         │
└─────────────────────────────────────────────────────────────────────────┘

Integration checklist

Phase 1 — Preparation (Your team)

Phase 2 — Configuration (Alvio + You)

Phase 3 — Development (Your team)

What you need to prepare

1. Sending leads to Alvio

Your system must send an HTTP POST when a call fails:

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

Recommended optional fields: name, email, business context, assigned rep. See the webhook integration guide for the full payload.

2. Callback endpoint (receiving statuses)

You must expose an HTTPS URL to receive Alvio events:

POST https://your-domain.com/api/alvio/callback

Campaign notifications use event_type: "update" and an event_name. Configure a subscription for each event your CRM needs.

The subscriptions guide covers all events, their format, tests and retries. Accept null values, verify authentication and deduplicate notifications using event_id.

Existing integrations: older examples in this guide used status, crm_id, NOT_REACHABLE, OPT_OUT, NO_OUTCOME, FIRST_MESSAGE_DELIVERED, FIRST_MESSAGE_READ or RESPONSE_RECEIVED. They do not describe the current standard subscription contract. These names are not automatic aliases; retain any specific contract already in use and confirm its migration with Alvio.

What Alvio provides

What your marketing team needs to prepare

See the WhatsApp Business API Guide for configuration details.

Process a campaign callback

For an appointment, read event_name: "MEETING_BOOKED", the CRM identifier in external_references.contact_id and the schedule in data.start, data.end and data.timezone. The full JSON also includes lead and campaign details.

See the complete appointment, escalation and STOP examples. The standard contract does not automatically include conversation_transcript or a root-level ai_summary; alvio.conversation_url opens the conversation and data.notes can contain appointment notes.

Next steps

1. Configure a test campaign and retrieve its source URL and token.
2. Configure your destination and subscriptions in Webhooks.
3. Test both directions of the flow, including signatures and deduplication, before going live.

Questions? Our technical team is available to support you at every step.