Skip to main content

​
At a glance

  • Availability: Experimental (how to enable).
  • Authentication: API key.
  • Connection: The key from WHATSAPP_ACCESS_TOKEN is sent as the Bearer prefixed Authorization header.
  • Provider documentation: Authentication reference.

​
Credentials

Set these per environment. See Connect an integration.

​
Setup

  1. 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.
  2. 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.
  3. 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.
  4. 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.
Provider API reference.

​
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.