Personal AI agent

What you need

A HookMyApp account
A connected WhatsApp channel (the sandbox for testing, or your own WhatsApp number)
A channel token and phone number ID for that channel
An agent runtime that can read incoming messages and send outgoing replies

If your channel is already connected, skip to Configure your agent.

Connect number

For testing, connect a sandbox session to your phone:

hookmyapp sandbox start

The CLI shows a code and a QR.
Open the QR on your phone and send the prefilled WhatsApp message to HookMyApp test number.
See Sandbox for the full flow. To use your own number, connect your WhatsApp Business number through Meta embedded signup:

hookmyapp channels connect

See Connect WhatsApp for the full embedded-signup flow.

Configure agent

Pull credentials into a .env file your agent runtime can load. For a sandbox session:

hookmyapp sandbox env --write .env

For a connected channel:

hookmyapp channels env <channel> --write .env

Your agent reads these values:

META_GRAPH_API_URL: the base URL your agent sends through for this channel (the sandbox writes WHATSAPP_API_URL instead)
WHATSAPP_ACCESS_TOKEN: channel token for sending messages
WHATSAPP_PHONE_NUMBER_ID: the WhatsApp number your agent sends from
WEBHOOK_HMAC_SECRET: webhook signing secret for your receiver

The receiver shape is identical between the sandbox and your own number.

Agent capabilities

Your agent can receive messages, send replies, and use the CLI to inspect the connected number.

Send messages

Use the send URL and token from the env values. See Send text for the basic message shape.

Listen to conversations

For local development, listen for messages on your laptop:

hookmyapp sandbox listen

For your own number, set the public URL where HookMyApp sends messages:

hookmyapp channels webhook set <channel> \
  --url https://your-agent.example.com/webhook \
  --verify-token $(openssl rand -hex 32)

Use with agent framework

If your agent runs on OpenClaw or Hermes, use the native HookMyApp adapter — install it, run its setup command, and your agent sends and receives WhatsApp messages with no transport code:

For other runtimes, give your agent the HookMyApp CLI and a prompt:

Agent prompt

You can send and receive WhatsApp messages on my behalf through the
HookMyApp CLI (npm package @gethookmyapp/cli).

Setup:
1. Install the HookMyApp skills globally:  npx skills add hookmyapp/agent-skills --all --global
2. Install the CLI:  npm install -g @gethookmyapp/cli
3. Authenticate: run `hookmyapp login --email <my-email>` (a 6-digit code arrives in my inbox, and I will read it back to you), or I will run `hookmyapp login` myself in a browser
4. List my connected channels:  hookmyapp channels list --json

To send a message:
1. Pull the channel credentials:  hookmyapp channels env <channel> --json
2. Send through the HookMyApp API URL from those values, using the WhatsApp message body shape.

Always run `hookmyapp <command> --help` before using a command.
Only message the
people I explicitly ask you to, and never contact anyone without my confirmation.

For deeper, framework-specific wiring, point your agent at the agent skills and the CLI reference.
For other runtimes (Python, Go, Rust), use the same env values and adapt the transport on your side.

Next steps

Build with AI: Use Cursor, Codex, or Claude Code to wire all this for you.
CLI: Command reference for everything above.
Send text: Send a WhatsApp text message.
Receive webhooks: Inbound webhook handling and signature verification.

Getting started

Sending & receiving

Tools

Self-managed setup

FAQs

API Reference

What you need

Connect number

Configure agent

Agent capabilities

Send messages

Listen to conversations

Use with agent framework

Next steps

​What you need

​Connect number

​Configure agent

​Agent capabilities

​Send messages

​Listen to conversations

​Use with agent framework

​Next steps

What you need

Connect number

Configure agent

Agent capabilities

Send messages

Listen to conversations

Use with agent framework

Next steps