Documentation menu

DocumentationReach your customers

Channels: Gmail, WhatsApp and more with n8n

Let your agent answer Gmail, WhatsApp, Messenger, Instagram or any platform through your own n8n: the API key, templates and reply modes.

Your agent can also answer in writing on Gmail, WhatsApp, Messenger, Instagram, Slack, SMS or any other messaging platform. Your own n8n connects to the platform and keeps its logins: it sends each incoming message to VeyCall, which writes the reply with the agent's instructions, knowledge and calendar. With the API and webhooks activation.

  1. In Integrations › n8n channels, create an API key. In n8n, save it as a Header Auth credential named "VeyCall API key" (name Authorization, value Bearer vc_live_…).
  2. Download a template (Gmail, WhatsApp, WhatsApp by QR code, any platform, approved replies), import it in n8n and paste your agent's id.
  3. Choose each channel's mode, then turn the workflow on.
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?"
}

The answer says what to do:

  • reply: send reply.text (and reply.subject for email).
  • pending_approval: the reply waits in Conversations › To approve.
  • handoff: the agent hands over to your team, who get an email; reply may hold a short holding message.
  • ignored: nothing to send (auto-reply, mailing list, no-reply sender, empty message or channel off).

Modes per agent and channel: answer right away (the default for chat platforms), after approval (the default for email) or off. An approved reply goes to your n8n through the channel.reply webhook (signed like every webhook), or n8n fetches it with GET /api/v1/channels/replies?status=approved_unsent; it then marks it sent with POST /api/v1/channels/replies/{id}/sent. Sending the same message_id again returns the same answer without charging twice. Messenger and Instagram use the "any platform" template (Meta webhook → VeyCall → Graph API request).

WhatsApp with your usual number (QR code)

The simplest, without n8n: Integrations › WhatsApp. Pick the agent, then either scan a QR code (number hosted by VeyCall) or enter your own OpenWA or Evolution API gateway's address, key and session. VeyCall does the rest. With the WhatsApp and Telegram activation.

Prefer to run everything through your n8n? The "WhatsApp by QR code" template uses the number you already have (WhatsApp or WhatsApp Business on your phone), with no per-message fees. It goes through an open-source gateway running next to your n8n: OpenWA (recommended) or Evolution API.

  1. Install the gateway (Docker), create a session and scan its QR code with your phone (WhatsApp › Linked devices).
  2. In the gateway, add a webhook to the workflow's production URL, with the event message.received (OpenWA) or MESSAGES_UPSERT (Evolution API).
  3. In n8n, create a Header Auth credential named "WhatsApp gateway key" (name X-API-Key for OpenWA, apikey for Evolution API), then paste your agent's id and the gateway's address in the Normalize node.

Your agent answers people who write to you; groups, statuses and your own messages are skipped. This goes through WhatsApp Web, not Meta's official API: WhatsApp may block a number that sends in bulk or gets reported. Keep it to answering your customers.