Learn · Setup guides

Connect WhatsApp Cloud API to Outloop

Let your agent do the setup

Copy this task into Claude Code or another agent with browser access. It will follow the guide and ask you when access or information is missing.

Read or select the prompt
Help me complete connect whatsapp cloud api to outloop using https://outloop.co/guides/connect-whatsapp-cloud-api-to-outloop.

Open that guide in your browser, read its full setup steps and linked official provider instructions, then perform the setup step by step using the tools available to you. If the guide cannot be opened, ask me for its contents before proceeding.

Identify the correct client Workspace, account, domain and environment before making changes. Inspect the current setup and preserve working settings. Ask me only for missing information, necessary authorization or access. Use an approved login-recovery tool when available. Otherwise, if a login such as GoDaddy, Google Admin or Microsoft 365 is required, ask me to sign in through the browser and resume after I finish. Never ask me to paste passwords, tokens, private keys or recovery codes into chat. Have me enter credentials directly into the authorized product form when needed.

Follow this guide’s actual provider-specific scopes, account identifiers, setup order and verification steps. Grant only the access required for the task. Keep secrets in the intended credential entry/storage path. Ask before creating paid resources, broadening permissions, rotating working credentials, publishing content or making destructive changes. Verify a bounded read-only operation in the intended client account before claiming the connection works. Do not launch campaigns, send messages or change production content merely to test authentication.

Continue through each supported step. If a human-only action or unavailable tool blocks progress, explain the exact action needed and resume when I complete it. Report what changed, what verification actually passed, and anything pending. Never claim completion based only on a success toast or a proposed command.

Last updated:

In short

Connect WhatsApp Cloud API without exposing tokens to your agents.

Outloop lets your agents use approved WhatsApp Cloud API access through a secure local bridge. The access token stays in your local secret store, and agents call the API through Outloop without seeing the raw token. You connect it with a WABA ID, a Phone Number ID, the Graph API version, and a Meta access token.

Summarize this setup guide with AI ChatGPTClaudePerplexity

What this setup gives you

Agents that need WhatsApp Cloud API access — to read phone-number details, check templates, or send approved messages — usually get a raw token pasted into a tool, a chat, or a .env file. With Outloop, the token stays in your local secret store and the agent requests the action through the API Bridge instead, so it never sees the raw token.

Security rule. Never paste API keys, access tokens, app secrets, client secrets, Authorization headers, or personal emails into chat, screenshots, docs, .env files, project folders, or generated artifacts. The token's only destination is the Outloop API key field.

What you need before starting

1. Find your WhatsApp Business Account ID

Open Meta Business Settings and go to Accounts → WhatsApp accounts. Select the WhatsApp Business Account you want to connect, and copy the ID shown next to the account name. This is your WhatsApp Business Account ID, also called the WABA ID.

Meta Business Settings showing WhatsApp accounts, the selected WhatsApp Business Account, and its WABA ID.

Example field in Outloop: WhatsApp Business Account (WABA) ID.

Important. The WABA ID is not your phone number. It is the Meta ID for the WhatsApp Business Account.

2. Find your Phone Number ID

Open WhatsApp Manager and go to Phone numbers. Select the connected WhatsApp number. At the top of the phone number details panel, find Phone number ID and copy that value into Outloop.

Meta WhatsApp Manager showing where to find the Phone Number ID for a connected WhatsApp number.

Example field in Outloop: Phone Number ID.

Important. The Phone Number ID is not the visible WhatsApp phone number. It is the internal Meta ID for that phone number.

3. Set the Graph API version

In Outloop, use the Graph API version field. The default version is:

v25.0

Do not include the version inside the base URL. Outloop uses the Meta Graph API host and builds the request path safely.

4. Create or use a Meta access token

Use a Meta access token that has access to the selected WhatsApp Business Account and phone number. Do not paste this token into:

Paste the token only into the Outloop API key field.

Important. If you already have a token working in another tool, such as n8n, creating a new token usually does not break the old one. Do not revoke or delete the old token until the new Outloop connection is tested.

5. Add the credential in Outloop

In Outloop, choose WhatsApp Cloud API and fill in:

Then click Add API Key. Outloop stores the token locally and does not show it again.

6. Run a safe read test

After saving the credential, run a read-only test first. The safe test should call:

GET /v25.0/<WABA_ID>/phone_numbers

A successful proof should show:

decision: allow
HTTP 200
audit entry exists
secret_exposed: false
Important. Do not test sending messages yet. Confirm read access first.

7. What counts as a real Outloop proof

A connection is only verified if the request goes through Outloop. A valid proof must include:

Common mistake. A result from Meta UI, n8n, MCP, an SDK, a browser connector, or another tool does not prove Outloop access.

8. Meta App Review note (optional)

Some Meta features require additional App Review or API testing activity before approval. If Meta asks for testing traffic or a usage description, complete those requirements inside Meta's developer dashboard.

Meta App Review screen showing Marketing API Access Tier testing requirement and API call threshold.

This is separate from storing the token in Outloop. Outloop can help run approved API requests safely, but Meta still controls permissions, review, rate limits, and feature approval.

9. Troubleshooting

If the test fails, check:

Common mistake. Using the visible phone number instead of the Phone Number ID.
Common mistake. Using an n8n hidden placeholder value instead of the real Meta access token.
Common mistake. Testing through another connector and assuming it proves Outloop access.

Outloop is available with setup guides and product support for agency teams. Outloop is an independent tool and is not affiliated with or endorsed by Meta or WhatsApp. See the security model, or the Meta Ads API setup guide.

Summarize this setup guide with AI ChatGPTClaudePerplexity

Once the read test succeeds, your agent can use WhatsApp Cloud API through Outloop — without seeing the raw token.

Outloop is available with setup guides and product support for AI agencies, operators, and dev shops.

Frequently Asked Questions

WhatsApp Cloud API + Outloop — FAQ