Webhook Integration Guide

Connect your chatbot to external services and APIs through webhooks. Enable real-time notifications, data synchronization, and automated workflows with third-party applications.

What You Can Do With Webhooks

✅ Send notifications to Slack, Discord, or email
✅ Create tickets in Zendesk, Jira, or other help desk systems
✅ Update customer records in CRM systems
✅ Trigger automated workflows in Zapier or Make
✅ Send data to analytics platforms

Step 1: Understanding Webhooks

Webhooks are HTTP callbacks that allow your chatbot to send data to external services when specific events occur. Think of them as automated messengers that deliver information to other applications in real-time.

How Webhooks Work

Event Occurs: A customer asks a question or triggers a specific action in your chatbot

Webhook Triggered: Your chatbot automatically sends an HTTP POST request to the configured webhook URL

External Service Receives: The target application receives the data and can process it accordingly

Common Use Cases

Customer Support

Create support tickets automatically
Notify team members of urgent issues
Log customer interactions

Sales & CRM

Update customer records
Create sales opportunities
Track lead interactions

Team Communication

Send alerts to Slack/Discord
Email notifications
SMS alerts for urgent matters

Data & Analytics

Log customer queries
Track chatbot performance
Export data to external systems

Step 2: Setting Up Webhooks in EchowiseAI

Now let's configure webhooks in your EchowiseAI dashboard. You'll need to set up the webhook URL, configure the payload structure, and define when the webhook should be triggered.

Add Webhook as a New Action

1
Access Actions Panel: In your EchowiseAI dashboard, click on Actions in the left sidebar
2
Install Webhook Skill: Find the Webhook skill card and click Install
3
Configure Webhook: Fill in the configuration form with your webhook details

Configuration Fields

AI Instructions* (Required)

Explain when this webhook should be triggered and what it's used for.

Example Instructions:

"This webhook should be triggered when:

Customers ask about technical support
Urgent issues are reported
Sales inquiries are made
Feature requests are submitted

It will create tickets in our Zendesk system and notify the support team."

* This field helps your AI understand when to trigger the webhook vs. using other responses

Webhook URL* (Required)

The endpoint URL where the webhook data will be sent

Examples:

https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX
https://yourdomain.com/webhook/chatbot
https://api.zendesk.com/v2/tickets.json
https://webhook.site/your-unique-url

Webhook Payload* (Required)

Define the data structure that will be sent to the webhook endpoint

Common Payload Fields:

Use the "Add" button to add more key-value pairs as needed

💡Pro Tip

Test your webhook before saving by clicking the "Test Connection" button (if available). This helps ensure your endpoint is working correctly and can receive the data.

Step 3: Testing and Troubleshooting

After setting up your webhook, it's important to test it thoroughly and know how to troubleshoot common issues.

Testing Your Webhook

1. Use Webhook Testing Services

Test webhooks without setting up your own endpoint:

• webhook.site - Get a unique URL to test incoming webhooks
• RequestBin - Create temporary endpoints for testing
• ngrok - Expose local servers for testing

2. Test with Sample Data

Verify your webhook receives the expected data structure:

Expected JSON Response:

{
  "customer_name": "John Doe",
  "message": "I need help with my order",
  "timestamp": "2024-01-15T10:30:00Z",
  "chat_session_id": "abc123"
}

Common Issues and Solutions

❌ Webhook Not Receiving Data

Check if the webhook URL is correct and accessible
Verify the endpoint accepts POST requests
Check firewall and network settings
Ensure the service is not blocking incoming requests

⚠️ Authentication Issues

Add authentication headers if required (Bearer token, API key)
Check if the service requires specific authentication methods
Verify API keys and tokens are valid

ℹ️ Data Format Issues

Ensure the payload structure matches what the endpoint expects
Check if the service requires specific field names
Verify data types (strings, numbers, booleans)

Frequently Asked Questions

Are webhooks included in the free plan?▼

Yes! Webhook integration is included with all EchowiseAI plans, including our free tier. You can set up multiple webhooks to connect with various external services.

How many webhooks can I create?▼

The number of webhooks depends on your plan. Free users can create up to 3 webhooks, while paid plans allow unlimited webhook integrations.

What happens if my webhook endpoint is down?▼

If a webhook fails to deliver, EchowiseAI will retry up to 3 times with exponential backoff. After failed attempts, the webhook will be marked as failed, but your chatbot will continue to function normally.

Can I customize the webhook payload format?▼

Yes! You have full control over the payload structure. You can add custom fields, use dynamic variables like customer_name or timestamp, and format the data exactly as your external service expects.

Is there a delay when webhooks are triggered?▼

Webhooks are triggered in real-time, typically within a few seconds of the event occurring. The actual delivery time depends on your webhook endpoint's response time and network conditions.

Can I use webhooks with other actions?▼

Absolutely! Webhooks can be used alongside other actions like Shopify integration, knowledge bases, and custom actions. You can create complex workflows that combine multiple data sources and external services.