Skip to main content

Documentation Index

Fetch the complete documentation index at: https://help.asistian.com/llms.txt

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

Webhooks let Asistian communicate with external systems in real time. When something happens in Asistian — like a new conversation starting or a message arriving — an outbound webhook can notify your other tools instantly. Inbound webhooks work the other way: external systems can send data into Asistian by posting to a URL you configure. Together, they let you build automations without keeping a manual connection open.

​
Outbound webhooks

Use an outbound webhook to push events from Asistian to an external endpoint whenever something happens in your inbox.
1

Open webhook settings

In Asistian, go to Settings > Integrations > Webhooks.
2

Add a new outbound webhook

Click Add webhook and enter the destination URL where Asistian should send event data.
3

Select events

Choose which events should trigger the webhook — for example, new conversation, message received, or contact created.
4

Save and test

Save the webhook. Use the Send test option to verify your endpoint receives the payload correctly.

​
Inbound webhooks

Use an inbound webhook to send data into Asistian from an external system.
1

Generate your inbound webhook URL

In Settings > Integrations > Webhooks, create a new inbound webhook. Asistian generates a unique URL for you.
2

Configure your external system

Copy the webhook URL and paste it into the external tool or service that will send data to Asistian.
3

Send a POST request

Your external system should send an HTTP POST request with a JSON body to the webhook URL whenever you want to push data into Asistian.

​
Common use cases

  • New conversation alert — notify your internal CRM or helpdesk when a customer starts a new conversation in WhatsApp, Instagram, or Facebook.
  • Message received trigger — kick off an automation in your workflow tool every time Asistian receives a message in a specific inbox.
  • Contact sync — push new contact data from Asistian into an external database or spreadsheet as leads come in.
  • Appointment notification — send a confirmation to an external calendar or scheduling tool when an appointment is booked through Asistian.

​
Example event payload

When an event fires, Asistian sends a JSON payload to your endpoint. The structure will vary by event type, but a conversation event looks roughly like this: 
{
  "event": "conversation.created",
  "timestamp": "2025-01-15T10:30:00Z",
  "data": {
    "conversation_id": "conv_abc123",
    "channel": "whatsapp",
    "contact": {
      "id": "contact_xyz789",
      "name": "María López",
      "phone": "+521234567890"
    },
    "inbox": "Sales",
    "created_at": "2025-01-15T10:30:00Z"
  }
}
Secure your webhook endpoint by validating incoming requests. Asistian signs outbound webhook payloads so you can verify that a request genuinely came from Asistian. Check the request signature against your webhook secret before processing any payload.