skills.rest
octanutri-clin
octanutri-clinCOMMUNITY
Explore all skills by this author →
GitHub

whatsapp-cloud-api

Implements WhatsApp Cloud API messaging, webhooks, templates, and coexistence integrations.

Updated Jul 9, 2026
Search Tags:#messaging#templates#integration#whatsapp#webhooks#meta#cloud api
One-click install
npx skills add https://github.com/octanutri-clin/octaclin --skill whatsapp-cloud-api-octanutri-clin
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: whatsapp-cloud-api
Source: https://github.com/octanutri-clin/octaclin/tree/main/.agents/skills/whatsapp-cloud-api
Command: npx skills add https://github.com/octanutri-clin/octaclin --skill whatsapp-cloud-api-octanutri-clin

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Building WhatsApp Business integrations requires navigating Meta's Cloud API surface — message types, webhook payloads, conversation windows, template rules, rate limits, and error codes — and getting any of these wrong causes failed deliveries or billing surprises. This Skill provides the complete official API reference so an AI agent can write correct integration code on the first attempt. ## Core Features & Use Cases - Message Sending: Covers all message types (text, image, video, audio, document, sticker, location, contacts, reaction, interactive buttons/lists, and templates) through the single POST /{phone-number-id}/messages endpoint. - Webhook Processing: Documents verification handshakes, incoming message payloads, status updates (sent/delivered/read/failed), signature validation, and idempotency handling. - Conversation & Billing Rules: Explains the 24-hour customer service window, template categories (marketing, utility, authentication), per-message pricing, and free entry points. - Coexistence Support: Details running one number on both the WhatsApp Business App and Cloud API, including Embedded Signup onboarding, history sync, and smb_message_echoes webhooks. - Use Case: A developer adding WhatsApp appointment reminders to a clinic SaaS can use this Skill to send template messages, process patient replies via webhooks, and handle re-engagement errors correctly. ## Quick Start Use the whatsapp-cloud-api skill to write a function that sends a text message to +18091234567 and handles the webhook response.

Frequently Asked Questions about whatsapp-cloud-api

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I send a WhatsApp message using the Cloud API?▼

Send a POST request to https://graph.facebook.com/v21.0/{phone-number-id}/messages with a Bearer access token and a JSON body containing messaging_product set to whatsapp, the recipient in E.164 format, and a type such as text or template. The response returns a wamid message ID for tracking.

How do WhatsApp webhook verification and payload processing work?▼

Meta sends a GET request with hub.mode, hub.verify_token, and hub.challenge; return the challenge value with status 200 if the token matches. For POST events, validate the X-Hub-Signature-256 HMAC, respond 200 immediately, and process messages or statuses asynchronously.

What is the WhatsApp 24-hour customer service window?▼

When a customer messages you, a 24-hour window opens during which you can send any message type for free. Outside the window, only pre-approved template messages can be sent, and they are billed per message by category.

Can one number run on both the WhatsApp Business App and Cloud API?▼

Yes, through coexistence onboarding via Embedded Signup with featureType whatsapp_business_app_onboarding. App-sent messages are mirrored to your webhook via smb_message_echoes, but coexistence numbers are capped at 20 messages per second.

Why does my WhatsApp message fail with error 131047?▼

Error 131047 means the 24-hour customer service window has expired, so free-form messages cannot be delivered. Send an approved template message to re-open the conversation instead of retrying the original message.

What are the WhatsApp Cloud API rate limits and messaging tiers?▼

The Cloud API allows 80 messages per second per phone number, with pair rate limits per recipient. New numbers start at Tier 1 with 1,000 unique customers per 24 hours and upgrade automatically with a GREEN quality rating and 7 days of activity.

Related Skills

Explore More Software Engineering Skills→
RADHA0-maxRADHA0-max
2

add-whatsapp-cloud

Installs and configures a WhatsApp Business Cloud API channel adapter for NanoClaw.

Community
Intermediate
ilyautovilyautov
16

call-list

Ranks top leads to call today and drafts talking points, calendar blocks, and follow-up emails.

Community
Intermediate
delta-and-betadelta-and-beta

tester-whatsapp-qa

Validate WhatsApp delivery, quality ratings, and opt-in/out processing in Braze workflows.

Community
Advanced
openaiopenai
5.3k

twilio-content-template-builder

Create, approve, and send Twilio Content API message templates across WhatsApp, SMS, RCS, and MMS.

Official
Intermediate