Twilio WhatsApp

Complete LangChain Agent Example and keep the Agent process running.

1. Create the Channel

In Channels, choose Twilio WhatsApp. Enter the Twilio Account SID, authentication credential, and WhatsApp sender. GroundForge verifies Twilio signatures by default. Attach the Channel to the weather Agent and publish the Agent.

2. Configure the callback

Copy the callback shown by GroundForge after publishing:

https://platform.groundforge.ai/v1/agents/{agent_id}/channels/{channel_id}/callback

Paste it into Twilio’s inbound-message webhook field. When status callbacks are enabled, GroundForge also shows the separate status URL.

Screenshot placeholder
Add /images/guides/twilio-callback.png showing the GroundForge callback and matching Twilio webhook field.

3. Preview the delivery test

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

Check the Channel ID, recipient, and body.

4. Send the test

Run the same command without --dry-run:

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

For the Twilio sandbox, the recipient must have joined the sandbox. Store the sandbox sender in the Channel; pass the recipient only in the test command. Sender and recipient must be different.

5. Follow the request

Open Traces and confirm Channel input, get_weather, the Gateway decision, and Channel output.

Overview

Concepts

Examples

Platform

SDK

CLI

REST APIs

Operations

Reference

1. Create the Channel

2. Configure the callback

3. Preview the delivery test

4. Send the test

5. Follow the request

​1. Create the Channel

​2. Configure the callback

​3. Preview the delivery test

​4. Send the test

​5. Follow the request

1. Create the Channel

2. Configure the callback

3. Preview the delivery test

4. Send the test

5. Follow the request