{/* Generated by scripts/generate-integration-catalog.mjs. Do not edit by hand. */}
At a glance
- Availability: Experimental (how to enable).
- Authentication: API key.
- Connection: The key from
WHATSAPP_ACCESS_TOKENis sent as theBearerprefixedAuthorizationheader. - Provider documentation: Authentication reference.
Credentials
Set these per environment. See Connect an integration.
Setup
- Create a Meta app with the WhatsApp product: Sign in at https://developers.facebook.com (a free Meta developer account works), create a Business-type app, and add the WhatsApp product. Meta provisions a free test phone number and sandbox automatically.
- Get a test token and phone number ID: In WhatsApp > API Setup, copy the temporary access token and the Phone number ID for the test number. Add up to 5 verified recipient numbers for sandbox testing. Set WHATSAPP_ACCESS_TOKEN and WHATSAPP_PHONE_NUMBER_ID.
- Note your WhatsApp Business Account ID: The WABA ID is shown in WhatsApp > API Setup (and in Meta Business Suite). Set it as WHATSAPP_BUSINESS_ACCOUNT_ID if you want to list message templates.
- Create a permanent token for production: Temporary tokens expire after about 24 hours. For production, create a System User in Meta Business Suite, grant it the whatsapp_business_messaging and whatsapp_business_management permissions, generate a non-expiring token, and use it as WHATSAPP_ACCESS_TOKEN.
Provider notes
- Free-form text messages are only delivered within 24 hours of the customer's last message; outside that window you must send an approved template.
- Use the internal phone number ID in API calls, not the E.164 phone number.
- New templates must be approved by Meta before they can be sent; check status with the List Message Templates tool.
Tools
Verify the connection
Call a read tool such as whatsapp__get_media_url with arguments for your account. Confirm that the result comes from the intended account or workspace before enabling write tools.