> ## Documentation Index
> Fetch the complete documentation index at: https://docs.telzino.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Slack Notification

> Have your AI agent post a message to a Slack channel during a call, using a Slack Incoming Webhook.

The **Slack Notification** function lets your AI agent post a message to a Slack channel while a call is in progress. The agent writes the message itself from the conversation, following your instructions. Each Slack Notification posts to one channel, set by its Incoming Webhook URL.

This is different from [Notify](https://docs.telzino.com/functions/notify.md), which sends a fixed-format summary by email or SMS at the end of the call.

You can add it in the Telzino Dashboard agent editor or in the Connect App.

[How to add a Slack notification to a Telzino AI agent](https://www.youtube-nocookie.com/embed/Wx60ojOJkAw)

## Before you start

**1. Make sure Slack is allowed for the organization**

**Slack Notification** only appears in **Add function** when Slack is allowed for the organization. Partners and resellers control this under **Integrations** and in [Feature Administration](https://docs.telzino.com/admin-guide/dashboard/feature-administration.md).

**2. Create a Slack Incoming Webhook**

In Slack, open your Slack app's **Incoming Webhooks** page, turn it on, click **Add New Webhook to Workspace**, pick the channel and copy the URL. It starts with `https://hooks.slack.com/services/`.

> [!WARNING]
>
> Treat the webhook URL like a password. Anyone who has it can post to that channel.

## Add a Slack Notification

> [tab] Telzino Dashboard
>
> 1. Open the agent in the dashboard and go to **Functions**.
> 2. Click **Add function**, then click **Add** next to **Slack Notification**.
> 3. In **Configure Slack Notification**, fill in the fields below and click **Add Function**.

> [tab] Connect App
>
> 1. Open the **AI Agents** tile, then click the agent's **Edit** icon.
> 2. On **Basic Settings**, under **Functions**, click **Add**.
> 3. In **Add Functions**, choose **Slack Notification** ("Send a message to a Slack channel via an Incoming Webhook URL."), fill in the fields below and save.

| Field | Description |
| - | - |
| **Slack Incoming Webhook URL** | Required. Must start with `https://hooks.slack.com/`, otherwise the form shows "URL must start with [https://hooks.slack.com/](https://hooks.slack.com/)". |
| **Instructions** | When the agent should post and what to include. If you leave it empty, the example text shown in the field is used. |

To change one later in the dashboard, click its edit icon in the Functions list. The dialog title changes to **Edit Slack Notification**, and the button to **Save Changes**.

> [!TIP]
>
> You can add Slack Notification more than once on the same agent, for example one per channel, each with its own URL and instructions.

## How it works

When the conversation matches your instructions, the agent calls the function during the call. Telzino sends a `POST` to the webhook URL with `Content-Type: application/json` and a body of `{"text": "<message>"}`, and Slack shows the message in the channel.

### Example instructions

```plaintext theme={null}
When the caller agrees to a demo, send their name, phone number and requested time.
```

```plaintext theme={null}
If the caller is upset or asks for a person, send a short alert with their name, phone number and a one-sentence summary of the issue.
```

Say both *when* to post and *what* to include. Instructions that only describe the content may never trigger.

## Configure with the API

A Slack Notification is stored in `extensions.tools` as a `webhook` tool named `send_slack_notification`. The dashboard saves it like this:

```json theme={null}
{
  "name": "send_slack_notification",
  "type": "webhook",
  "friendlyName": "Slack_Notification",
  "description": "When the caller agrees to a demo, send their name, phone, and requested time.",
  "url": "https://hooks.slack.com/services/T.../B.../xxxxxxxxxxxxxxxx",
  "method": "POST",
  "condition": "during_call",
  "headers": [{ "key": "Content-Type", "value": "application/json" }],
  "parameters": [
    { "key": "text", "value": "The text to post to Slack, composed by the agent from the conversation." }
  ]
}
```

* `name` must be exactly `send_slack_notification`, or the dashboard shows the entry as a generic webhook.
* `description` holds your instructions.
* Keep the single `text` parameter.

See [Update Agent](https://docs.telzino.com/api-reference/agents/update.md) and [Webhooks](https://docs.telzino.com/functions/webhooks.md).

> [!NOTE]
>
> The Slack allowlist hides the function in the editor. The agent API doesn't check it for tools, so a Slack Notification added through the API is saved even when Slack isn't allowed for the organization.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.