Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/KevinhosUTP/Automatizacion-Lurwis/llms.txt

Use this file to discover all available pages before exploring further.

The WhatsApp Business API integration enables the platform to receive customer messages via webhooks and send automated responses through Meta’s Cloud API.

​
Prerequisites

  • Meta Business account
  • WhatsApp Business app registered
  • Phone number verified with Meta
  • Access token from Meta for Developers

​
Webhook Setup

1

Create webhook endpoint

The platform exposes a webhook at /webhook/meta-verify to receive WhatsApp messages.
{
  "path": "meta-verify",
  "methods": ["GET", "POST"],
  "responseMode": "responseNode"
}
2

Configure webhook in Meta for Developers

Navigate to your WhatsApp Business app configuration:
  1. Go to Meta for Developers Console
  2. Select your app → WhatsApp → Configuration
  3. Add webhook URL: https://your-domain.com/webhook/meta-verify
  4. Set verify token: meta-verify
  5. Subscribe to messages field
3

Verify webhook challenge

Meta sends a GET request with parameters to verify ownership:
// Verification logic
if (query['hub.mode'] === 'subscribe' && 
    query['hub.verify_token'] === 'meta-verify') {
  return query['hub.challenge']; // Return challenge as plain text
}
The webhook validates:
  • hub.mode equals “subscribe”
  • hub.verify_token matches “meta-verify”
  • Returns hub.challenge with status 200

​
Message Reception

When WhatsApp receives a message, Meta sends a POST request with this structure: 
{
  "object": "whatsapp_business_account",
  "entry": [{
    "id": "746650594705809",
    "changes": [{
      "value": {
        "messaging_product": "whatsapp",
        "metadata": {
          "display_phone_number": "15551933641",
          "phone_number_id": "947279508470714"
        },
        "contacts": [{
          "profile": { "name": "Cliente" },
          "wa_id": "51900769907"
        }],
        "messages": [{
          "from": "51900769907",
          "id": "wamid.HBg...",
          "timestamp": "1771142227",
          "text": { "body": "pedido" },
          "type": "text"
        }]
      },
      "field": "messages"
    }]
  }]
}

​
Sending Messages

To send responses back to customers, the platform uses the WhatsApp Cloud API: 
POST https://graph.facebook.com/v21.0/{phone_number_id}/messages

Headers:
  Authorization: Bearer {access_token}
  Content-Type: application/json

Body:
{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "{customer_phone_number}",
  "type": "text",
  "text": {
    "body": "¡Hola! ¿En qué puedo ayudarte hoy? 🦐"
  }
}

​
Credentials Configuration

Store these credentials securely in n8n or environment variables:
FieldDescriptionExample
Access TokenMeta app access tokenEAABsbCS...
Phone Number IDWhatsApp Business phone number ID947279508470714
Verify TokenCustom token for webhook verificationmeta-verify
Webhook URLPublic endpoint for receiving messageshttps://server.com/webhook/meta-verify
Access tokens expire periodically. Use system user tokens for production to avoid expiration.

​
Error Handling

The webhook implements multiple error response scenarios: 
// Returns 403 if verification fails
if (hub.mode !== 'subscribe' || hub.verify_token !== 'meta-verify') {
  return {
    statusCode: 403,
    body: 'Forbidden'
  };
}
Critical: Always return HTTP 200 to Meta within 20 seconds, even if processing fails. Use asynchronous processing for long-running tasks.

​
Rate Limits

  • Business (unverified): 1,000 conversations per 24 hours
  • Business (verified): Unlimited conversations
  • Message rate: 80 messages/second per phone number
  • Webhook timeout: 20 seconds

​
Testing

Test your webhook integration:
1

Test verification

curl "https://your-domain.com/webhook/meta-verify?hub.mode=subscribe&hub.verify_token=meta-verify&hub.challenge=TEST123"
# Should return: TEST123
2

Send test message

Send a message from your phone to the WhatsApp Business number and verify:
  • Webhook receives the message
  • Message is extracted correctly
  • Response is sent back
3

Check webhook logs

Monitor webhook calls in Meta for Developers:
  • Configuration → Webhooks → Test
  • Verify all messages show status 200

​
Troubleshooting

  • Verify the verify token matches exactly: meta-verify
  • Check that webhook URL is publicly accessible
  • Ensure HTTPS is properly configured
  • Return challenge as plain text, not JSON
  • Check webhook is subscribed to messages field
  • Verify phone number has active WhatsApp Business API
  • Check webhook logs in Meta console for errors
  • Ensure endpoint returns 200 within 20 seconds
  • Verify access token is valid and not expired
  • Check phone number ID matches the business number
  • Ensure recipient number is in E.164 format (e.g., 51900769907)
  • Verify message template is approved (for initial contact)

WhatsApp Cloud API Docs

Official Meta documentation

Receptor Workflow

See how messages are processed

Build docs developers (and LLMs) love

Get started for freeTalk to us