Menu de la documentation
DocumentationJoindre vos clients
Canaux : Gmail, WhatsApp et plus avec n8n
Votre agent répond sur Gmail, WhatsApp, Messenger, Instagram ou toute plateforme via votre propre n8n : la clé d'API, les modèles et les modes de réponse.
Votre agent peut aussi répondre par écrit sur Gmail, WhatsApp, Messenger, Instagram, Slack, SMS ou toute autre messagerie. C'est votre propre n8n qui se connecte à la plateforme et garde ses accès : il envoie chaque message reçu à VeyCall, qui rédige la réponse avec les instructions, les connaissances et l'agenda de l'agent. Avec l'activation API et webhooks.
- Dans Intégrations › Canaux n8n, créez une clé d'API. Dans n8n, enregistrez-la comme identifiant Header Auth nommé « VeyCall API key » (nom
Authorization, valeurBearer vc_live_…). - Téléchargez un modèle (Gmail, WhatsApp, WhatsApp par QR code, toute plateforme, réponses validées), importez-le dans n8n et collez l'identifiant de votre agent.
- Choisissez le mode de chaque canal, puis activez le workflow.
POST https://api.veycall.com/api/v1/channels/messages
Authorization: Bearer vc_live_…
{
"agent_id": "agent_…",
"channel": "gmail",
"conversation_id": "<thread id>",
"message_id": "<message id>",
"from": { "id": "jane@example.com", "name": "Jane Doe", "email": "jane@example.com" },
"subject": "Cleaning on Saturday",
"text": "Hello, can you come on Saturday morning?"
}La réponse indique quoi faire :
reply: envoyezreply.text(etreply.subjectpour un e-mail).pending_approval: la réponse attend dans Conversations › À valider.handoff: l'agent passe la main à votre équipe, qui reçoit un e-mail ;replypeut contenir un message d'attente.ignored: rien à envoyer (réponse automatique, liste de diffusion, expéditeur no-reply, message vide ou canal désactivé).
Modes par agent et par canal : répondre tout de suite (par défaut pour les messageries), après validation (par défaut pour l'e-mail) ou désactivé. Une réponse validée part vers votre n8n par le webhook channel.reply (signé comme les autres webhooks), ou n8n la récupère avec GET /api/v1/channels/replies?status=approved_unsent ; il la marque ensuite envoyée avec POST /api/v1/channels/replies/{id}/sent. Renvoyer le même message_id renvoie la même réponse sans facturer deux fois. Messenger et Instagram passent par le modèle « Toute plateforme » (webhook Meta → VeyCall → requête Graph API).
WhatsApp avec votre numéro habituel (QR code)
Le plus simple, sans n8n : Intégrations › WhatsApp. Choisissez l'agent, puis soit vous scannez un QR code (numéro hébergé par VeyCall), soit vous indiquez l'adresse, la clé et la session de votre propre passerelle OpenWA ou Evolution API. VeyCall s'occupe du reste. Avec l'activation WhatsApp et Telegram.
Vous préférez tout faire passer par votre n8n ? Le modèle « WhatsApp par QR code » utilise le numéro que vous avez déjà (WhatsApp ou WhatsApp Business sur votre téléphone), sans frais par message. Il passe par une passerelle open source installée à côté de votre n8n : OpenWA (recommandée) ou Evolution API.
- Installez la passerelle (Docker), créez une session et scannez son QR code avec votre téléphone (WhatsApp › Appareils connectés).
- Dans la passerelle, ajoutez un webhook vers l'URL de production du workflow, avec l'événement
message.received(OpenWA) ouMESSAGES_UPSERT(Evolution API). - Dans n8n, créez un identifiant Header Auth nommé « WhatsApp gateway key » (nom
X-API-Keypour OpenWA,apikeypour Evolution API), puis collez l'identifiant de votre agent et l'adresse de la passerelle dans le nœud Normalize.
Votre agent répond aux personnes qui vous écrivent ; les groupes, les statuts et vos propres messages sont ignorés. Cette méthode passe par WhatsApp Web et non par l'API officielle de Meta : WhatsApp peut bloquer un numéro qui envoie des messages en masse ou qui est signalé. Réservez-la aux réponses à vos clients.