whatsapp-business-1.0.3_skill

Overview

This skill provides a managed integration with the WhatsApp Business API using OAuth and a gateway proxy. It lets you send text, media, interactive and template messages, manage templates and media, and control connections without handling raw OAuth tokens. Use the gateway to simplify authentication and route requests to the Meta Graph API.

How this skill works

Requests are sent to the gateway base URL which proxies to the WhatsApp Business API and injects your managed OAuth token. You authenticate with a Maton API key in the Authorization header and optionally specify a connection via the Maton-Connection header. The skill supports message creation, media upload, template lifecycle, phone number and profile management, and connection management endpoints.

When to use it

• Send messages to customers programmatically from servers or backend services.
• Manage and send approved template messages to initiate conversations.
• Upload or reference media (images, audio, video, documents) for outbound messages.
• Handle interactive messages (buttons or lists) for richer customer flows.
• Control multiple WhatsApp Business OAuth connections from a single API key.

Best practices

• Store MATON_API_KEY in a secure environment variable and never embed it in client-side code.
• Use template messages to start conversations and respect the 24-hour messaging window for free-form replies.
• Use the Maton-Connection header when you have multiple WhatsApp connections to ensure the correct phone number is used.
• Host media files on publicly accessible URLs or upload via the media endpoint before sending.
• Respect rate limits (10 requests/sec per account) and implement retry/backoff on 429 responses.

Example use cases

• Transactional alerts: send order confirmations, shipping updates, and receipts via template messages.
• Customer support: exchange media and interactive messages in live conversations.
• Marketing opt-ins: deliver approved promotional content via templates where permitted.
• Appointment reminders: send scheduled reminders with a quick reply button to confirm or cancel.
• Document delivery: upload and send contracts, invoices, or receipts as document messages.