interactive_concierge.py
"""
Interactive Concierge
=====================
A WhatsApp concierge that uses every interactive UI feature to help
users find restaurants, activities, and entertainment.
Showcases: reply buttons, list messages, location pins, reactions,
mark-as-read, and image sending — all in one conversational flow.
Requires:
WHATSAPP_ACCESS_TOKEN, WHATSAPP_PHONE_NUMBER_ID
ANTHROPIC_API_KEY
uvx (for geocode-mcp server)
"""
from agno.agent import Agent
from agno.db.sqlite import SqliteDb
from agno.models.anthropic import Claude
from agno.os.app import AgentOS
from agno.os.interfaces.whatsapp import Whatsapp
from agno.tools.mcp import MCPTools
from agno.tools.websearch import WebSearchTools
from agno.tools.whatsapp import WhatsAppTools
agent_db = SqliteDb(db_file="tmp/concierge.db")
concierge_agent = Agent(
name="Concierge",
model=Claude(id="claude-sonnet-4-6"),
tools=[
WhatsAppTools(
enable_send_reply_buttons=True,
enable_send_list_message=True,
enable_send_location=True,
enable_send_reaction=True,
enable_send_image=True,
),
WebSearchTools(),
MCPTools(command="uvx --python 3.12 geocode-mcp"),
],
db=agent_db,
instructions=[
"You are a friendly concierge that helps users find restaurants, activities, and entertainment.",
"Use WhatsApp interactive features to create a smooth, tap-driven experience.",
"Follow this flow:",
"1. Greet the user and ask what they are in the mood for using send_reply_buttons "
"with options like: Dinner, Drinks, Entertainment.",
"2. When they pick, ask a follow-up preference using send_reply_buttons "
"(e.g., cuisine type for dinner, vibe for drinks).",
"3. Ask for their location or neighborhood (they can type it).",
"4. Search the web for matching venues in their area.",
"5. Present the top results using send_list_message with sections "
"(e.g., 'Top Picks' and 'Hidden Gems'), each row having a title and short description.",
"6. When they pick a venue from the list, use mcp_geocoding_get_coordinates to get "
"accurate latitude and longitude, then send the location using send_location.",
"7. Send an image of the venue if available using send_image with a URL from search results.",
"8. React to their original message with a contextual emoji using send_reaction.",
"Keep messages short and conversational. Use interactive elements instead of asking "
"the user to type whenever possible.",
"IMPORTANT: Do NOT send a long text summary that repeats what's already in an interactive message. "
"When sending reply buttons or list messages, only add a brief one-line intro — the interactive "
"element IS the message. Never use asterisks (*) around emoji for bold formatting.",
],
add_history_to_context=True,
num_history_runs=10,
add_datetime_to_context=True,
markdown=True,
)
agent_os = AgentOS(
agents=[concierge_agent],
interfaces=[Whatsapp(agent=concierge_agent, send_user_number_to_context=True)],
)
app = agent_os.get_app()
if __name__ == "__main__":
agent_os.serve(app="interactive_concierge:app", reload=True)
Run the Example
1
Set up your virtual environment
uv venv --python 3.12
source .venv/bin/activate
uv venv --python 3.12
.venv\Scripts\activate
2
Install dependencies
uv pip install -U "agno[mcp,os]" anthropic ddgs
3
Prepare uvx
Install uv, then verify
uvx is available:uvx --version
4
Export environment variables
export ANTHROPIC_API_KEY="your_anthropic_api_key_here"
export WHATSAPP_ACCESS_TOKEN="your_whatsapp_access_token_here"
export WHATSAPP_APP_SECRET="your_whatsapp_app_secret_here"
export WHATSAPP_PHONE_NUMBER_ID="your_whatsapp_phone_number_id_here"
export WHATSAPP_VERIFY_TOKEN="your_whatsapp_verify_token_here"
$Env:ANTHROPIC_API_KEY="your_anthropic_api_key_here"
$Env:WHATSAPP_ACCESS_TOKEN="your_whatsapp_access_token_here"
$Env:WHATSAPP_APP_SECRET="your_whatsapp_app_secret_here"
$Env:WHATSAPP_PHONE_NUMBER_ID="your_whatsapp_phone_number_id_here"
$Env:WHATSAPP_VERIFY_TOKEN="your_whatsapp_verify_token_here"
5
Run the example
Save the code above as
interactive_concierge.py, then run:python interactive_concierge.py