Webhooks

Set up webhooks to receive real-time notifications and integrate with external systems.

What are Webhooks?

Webhooks allow you to receive real-time notifications from ManySends when specific events occur. This enables you to integrate ManySends with your existing systems and automate workflows.

Real-time Updates

Get instant notifications about events

Custom Integrations

Connect with your existing systems

Automation

Trigger automated workflows

Data Synchronization

Sync data with external systems

Supported Webhook Events

Conversation Events

• conversation.created
• conversation.status_changed
• conversation.assigned
• conversation.resolved
• conversation.reopened

Message Events

• message.created
• message.updated
• message.deleted
• message.reaction_added
• message.reaction_removed

Agent Events

• agent.created
• agent.updated
• agent.deleted
• agent.status_changed

Label Events

• label.created
• label.updated
• label.deleted
• conversation.labeled

Setting Up Webhooks

Navigate to Webhook Settings

Go to Settings → Integrations → Webhooks to manage your webhooks.

Create New Webhook

Click "Create Webhook" and configure your webhook endpoint.

Configure Webhook Details

Set up the webhook configuration:

Webhook URL

The endpoint URL that will receive webhook events

Secret Key

Optional secret for webhook signature verification

Events

Select which events should trigger this webhook

Test Webhook

Send a test payload to verify your endpoint is working correctly.

Activate Webhook

Enable the webhook to start receiving real-time events.

Webhook Payload Format

Webhook payloads are sent as JSON with the following structure:

{
  "event": "conversation.created",
  "timestamp": "2024-03-05T10:30:00Z",
  "data": {
    "id": "conv_123",
    "status": "open",
    "inbox_id": 1,
    "contact_id": 456
  },
  "signature": "sha256=..."
}

Security Considerations

Use HTTPS

Always use HTTPS endpoints for webhooks to ensure data security.

Verify Signatures

Use webhook signatures to verify that requests are from ManySends.

Rate Limiting

Implement rate limiting on your webhook endpoints to prevent abuse.

Troubleshooting

Webhook Not Receiving Events

Check that your endpoint is accessible and responding with 200 status code.

Signature Verification Failed

Ensure you're using the correct secret key and signature verification method.

Timeout Issues

Make sure your endpoint responds within 30 seconds to avoid timeouts.

Best Practices

Implement retry logic for failed webhook deliveries
Log webhook events for debugging and monitoring
Handle duplicate events by checking event IDs
Monitor webhook performance and delivery rates