Skip to main content
Webhooks in SigmaMind let you receive real-time notifications about events happening in your AI agents.
Whenever an event is triggered (e.g., a conversation starts or ends), SigmaMind will send an HTTP POST request with a JSON payload to your configured webhook URL. This allows you to fetch conversation info from your agents in your own applications, CRMs, or monitoring systems.

​
How Webhooks Work

  • Each AI Agent can have its own webhook.
  • A single webhook URL can be reused across multiple agents.
  • When the selected event occurs, SigmaMind sends a signed JSON payload to your webhook endpoint.
  • Your system can then process this payload to perform actions like updating CRM records, triggering workflows, or logging analytics.
Think of webhooks as push notifications for your backend — you get updates instantly when something important happens in SigmaMind.

​
Supported Webhook Events

The following events are currently supported:
  • conversation_started – Triggered when a new customer conversation begins.
  • conversation_ended – Triggered when a conversation is closed or completed.
  • conversation_analysed – Triggered when call analysis is completed.
    Additional events such as node_executed and post_call_analysis_completed will be supported in future releases.

​
Creating Webhooks

You can create webhooks in two ways:

​
1. Using the Dashboard

You can configure webhooks from Agent Settings:
  1. Open the AI Agent you want to connect.
  2. Go to Agent Settings → Webhooks.
  3. Provide the following details -
    • Webhook Name - Set the name you want to give this webhook.
    • URL - Enter a webhook URL. You’ll find this from your system where you want to receive the events from SigmaMind.
    • Secret API Key - This is your SigmaMind API Key. You can get this from under the Settings menu on your dashboard.
  4. Hit Submit to add the Webhook.

​
2. Using the API

If you prefer programmatic control, you can use the Webhook API to register webhooks.
  • The name field is a human-readable identifier for your webhook.
  • The url is the endpoint in your system that will receive webhook events.
  • The agentId must correspond to an existing Agent in your SigmaMind account.
  • The secret is used to sign payloads for verification.
  • The events parameter lists which Agent events will trigger the webhook.
curl --location 'https://api.sigmamind.ai/v1/webhooks' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: key_C6HL3Goru7Q.TlI5kZOKPmDM03Gt39nRBEnxrL*******************' \
--data '{
    "name": "Test Webhook 1",
    "url": "https://your-server.com/webhooks/ai-agent",
    "agentId": "D5D0p7TUs66TTAEAx",
    "secret": "your-signing-secret",
    "events": [
        "conversation_started",
        "conversation_ended"
    ]
}'

​
Security and Verification

  • All webhook payloads are signed using the secret you provide during setup.
  • Your server should validate the signature to confirm the request is authentic and originated from SigmaMind.
Always verify signatures before processing webhook data to prevent spoofing attacks.

​
Summary

  • Webhooks notify your system in real time about Agent events.
  • You can create webhooks from the Dashboard or via the API.
  • A single webhook URL can be used across multiple AI Agents.
  • Supported events include conversation_started and conversation_ended.
  • Payloads are signed with a secret key for secure delivery.
Webhooks are the easiest way to integrate SigmaMind into your existing systems and automate workflows.