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

# Channels

> Create a Channel, publish its callback, and test delivery safely.

Open **Channels** in [platform.groundforge.ai](https://platform.groundforge.ai) and choose a provider.

| Twilio                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | Mailgun                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | Slack                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | Webhook                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <img src="https://mintcdn.com/groundforgeai/V4bCNZADLwZmOUhb/images/logos/twilio.svg?fit=max&auto=format&n=V4bCNZADLwZmOUhb&q=85&s=23137771bd5787e2f879be0b011b0f6f" alt="Twilio" width="180" height="52" data-path="images/logos/twilio.svg" /> | <img src="https://mintcdn.com/groundforgeai/V4bCNZADLwZmOUhb/images/logos/mailgun.svg?fit=max&auto=format&n=V4bCNZADLwZmOUhb&q=85&s=e44f0beff51cba2ce8e643efff40199b" alt="Mailgun" width="190" height="52" data-path="images/logos/mailgun.svg" /> | <img src="https://mintcdn.com/groundforgeai/V4bCNZADLwZmOUhb/images/logos/slack.svg?fit=max&auto=format&n=V4bCNZADLwZmOUhb&q=85&s=bbd3c9f49d4ac80988ae7897c35bca1e" alt="Slack" width="170" height="52" data-path="images/logos/slack.svg" /> | <img src="https://mintcdn.com/groundforgeai/V4bCNZADLwZmOUhb/images/logos/webhook.svg?fit=max&auto=format&n=V4bCNZADLwZmOUhb&q=85&s=d78ae7cf3160792c859045b3c88be684" alt="Webhook" width="180" height="52" data-path="images/logos/webhook.svg" /> |

## 1. Create the Channel

Enter the provider-specific sender, credential, verification, and delivery settings. Save the Channel in the same Workspace as the Agent.

> **Screenshot placeholder**\
> Add `/images/platform/channel-create.png` showing the provider picker and Channel form.

## 2. Attach it to an Agent

Open the Agent, select the Channel, save, and publish the Agent. GroundForge then shows the recommended callback URL:

```text theme={null}
https://platform.groundforge.ai/v1/agents/{agent_id}/channels/{channel_id}/callback
```

Copy that exact URL into Twilio, Mailgun, Slack, or your webhook sender. Do not construct the IDs yourself.

## 3. Preview a test

Twilio WhatsApp:

```bash theme={null}
export TEST_WHATSAPP_TO="whatsapp:+<country-code><recipient-number>"

gforge channels test <channel-id> \
  --to "$TEST_WHATSAPP_TO" \
  --body "What is the weather in Ottawa?" \
  --dry-run \
  -o yaml
```

Mailgun:

```bash theme={null}
gforge channels test <channel-id> \
  --to "<recipient@example.com>" \
  --subject "Weather request" \
  --body "What is the weather in Ottawa?" \
  --dry-run \
  -o yaml
```

The dry run prints the request without sending a provider message.

## 4. Send the test

Run the same command without `--dry-run`. Then open the Channel and Trace pages to confirm provider delivery and Agent execution separately.

## Example

Use the Channel with [LangChain Agent Example](/examples/langchain-agent), then follow either [Twilio WhatsApp](/guides/twilio-whatsapp) or [Mailgun](/guides/mailgun).

See [CLI Resources](/cli/resources) for more `channels` options.


## Related topics

- [Channels](/concepts/channels.md)
- [Get Channel](/api-reference/endpoints/channels/get-channel.md)
- [Test Channel](/api-reference/endpoints/channels/test-channel.md)
- [Update Channel](/api-reference/endpoints/channels/update-channel.md)
