# Agent Webhook Skill

<figure><img src="/files/rC8XmBppuQgFoy2K2hzH" alt=""><figcaption></figcaption></figure>

## Customizable Agent Webhook

A fully customizable webhook allows your AI agent to communicate in real time with external systems or services, enabling dynamic data exchange such as updating CRMs, sending notifications, or retrieving live info. This flexibility ensures your AI can adapt to specific business workflows, making it more powerful, responsive, and integrated into your tech stack.

<figure><img src="/files/CoMesEXcOMY2IHEyofOJ" alt=""><figcaption></figcaption></figure>

## Webhook Name & Description

The **Webhook Name** is a clear, recognizable label used to identify the purpose or target of the webhook, helping you stay organized when managing multiple integrations. The **Webhook Description** provides a brief explanation of what the webhook does, offering context for its function and usage within your system.

<figure><img src="/files/rXKQvi37VMM9GGcp7f9u" alt=""><figcaption></figcaption></figure>

## Webhook to call to

The “Webhook to Call” field specifies the exact URL the AI will send data to when the webhook is triggered. This allows real-time communication between your AI agent and external systems, enabling dynamic actions like database updates, CRM integration, or workflow automation.

<figure><img src="/files/wKMbiHQqUJK8jmSpV8Ql" alt=""><figcaption></figcaption></figure>

## Webhook Trigger Condition

Webhook trigger conditions define when an external action (like sending data to another app) should be executed during a conversation—such as after each message, when a dialog starts, or when it ends. Choosing the right trigger ensures timely and relevant data transfer, automation, or notifications based on the flow of the chat.

<figure><img src="/files/YXrlgdjPjBiJ3W4AedTJ" alt=""><figcaption></figcaption></figure>

## Header Name & Value

Header names and values are key-value pairs sent with web requests that provide essential metadata—like authentication tokens, content type, or custom identifiers—allowing secure, structured, and contextual communication between systems. They're especially important for APIs and webhooks to verify, route, or process requests correctly.

<figure><img src="/files/6rfSoi1MCRCkiHRyuKIc" alt=""><figcaption></figcaption></figure>

## Ability to test your Webhook

Being able to test your webhook beforehand is crucial to ensure it’s correctly configured, the endpoint is reachable, and the expected data is being sent and received properly. It helps catch errors early, saving time and preventing issues when the AI is live and interacting with real users or systems.

<figure><img src="/files/nAUq17Snl2dQNt3YwVf2" alt=""><figcaption></figcaption></figure>

## [Webhook Setup Video](https://www.youtube.com/watch?v=2GQcKAVoBVs)

{% embed url="<https://www.youtube.com/watch?v=2GQcKAVoBVs>" %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.raiaai.com/raia-cx/agent-skills/agent-webhook-skill.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.