Lead Capture Webhooks

If you collect visitor names and emails before they start a chat, you can use Webhooks to automatically send this contact information directly to external platforms like Zapier, Make.com, or your own internal CRM.

Key Features

• Instant Data Sync: Automatically forward captured leads to your external tools the moment a user submits their details.
• Standardized JSON Payload: Sends a clean, predictable data format containing the user's name, email, and submission timestamp.
• Spam & Duplicate Prevention: Built-in safeguards prevent the same user from flooding your external databases with duplicate entries.

How to Use

Setting up the Webhook

1. Navigate to the Integrations tab in your Apoyo dashboard.
2. Locate the Lead Capture Webhook card.
3. Paste your destination URL (e.g., your Zapier or Make.com Catch Hook URL) into the input field.
4. Click the Save Webhook button.

Webhook Payload Format

When a visitor fills out the initial Lead Capture form to start a chat, Apoyo immediately sends a POST request to your saved webhook URL.

The request will contain a JSON body with the following exact structure:

JSON

{
  "spaceId": "your_workspace_id",
  "name": "Jane Doe",
  "email": "jane@example.com",
  "timestamp": "2026-03-25T18:20:00.000Z"
}

Important Notes (or Pro Tips)

• Data Limits: For security and database integrity, visitor names are capped at 100 characters, and email addresses are capped at 255 characters.
• Spam Prevention (Anti-Enumeration): Apoyo automatically checks if a lead with the same email already exists in your workspace. If a duplicate is detected, the system will quietly allow the user to chat but will not fire the webhook again. This protects your external CRMs from duplicate entries and malicious spam flooding.
• Security Restrictions (SSRF): For security reasons, your webhook URL must use a valid http or https protocol. It cannot point to local or private IP addresses (e.g., localhost or 192.168.x.x). Internal network destinations will be explicitly blocked by the system.