WhatsApp

Use WhatsApp with Agno agents.

Prerequisites

Set up a Meta Developer App

1. Go to the Meta Developer Portal and create a developer account.
2. Create a new Business app at the Apps Dashboard.
3. Add the WhatsApp product to your app from the app dashboard.
4. In WhatsApp > API Setup, note your Phone Number ID and generate an Access Token.

Configure environment variables

export WHATSAPP_ACCESS_TOKEN=your_access_token
export WHATSAPP_PHONE_NUMBER_ID=your_phone_number_id
export WHATSAPP_RECIPIENT_WAID=recipient_phone_number   # e.g. 1234567890

For first-time outreach to a user, you must use pre-approved message templates. Test messages can only be sent to numbers registered in your test environment.

Example

The following agent sends a template message via WhatsApp:

cookbook/91_tools/whatsapp_tools.py

from agno.agent import Agent
from agno.models.google import Gemini
from agno.tools.whatsapp import WhatsAppTools

agent = Agent(
    name="whatsapp",
    model=Gemini(id="gemini-3-flash-preview"),
    tools=[WhatsAppTools()],
)

agent.print_response(
    "Send a template message using the 'hello_world' template in English to [phone]"
)

Run the Example

pip install agno google-generativeai
python whatsapp_tools.py

For more examples, see the WhatsApp cookbooks.