manychat_skill

Overview

This skill provides a managed ManyChat API integration that handles authentication and proxies requests to ManyChat endpoints. It lets you manage subscribers, tags, custom fields, bot fields, flows, and send messages through Facebook Messenger with built-in rate-awareness. Use it to centralize ManyChat operations without handling raw API tokens in each call.

How this skill works

Requests go through a gateway that injects your API key and forwards calls to the native ManyChat API paths. Set your MATON_API_KEY as the Authorization bearer token and optionally specify a connection via the Maton-Connection header for accounts with multiple ManyChat connections. The gateway exposes endpoints for page, subscriber, tag, custom field, bot field, flow, growth tool, and sending operations.

When to use it

• Add, update, or import subscribers and manage subscriber custom fields and tags.
• Send messages, flows, or OTN notifications to subscribers or by user_ref.
• Create or manage page-level tags, custom fields, and bot fields used by automations.
• List flows, growth tools, OTN topics, or page metadata for monitoring and automation.
• When you want an authenticated proxy to ManyChat that centralizes token management and supports multiple connections.

Best practices

• Store MATON_API_KEY securely in environment variables and never embed it in client-side code.
• Specify Maton-Connection when working with multiple ManyChat pages to avoid actions on the wrong account.
• Respect stated rate limits per endpoint (e.g., 10–100 qps) and batch updates when possible.
• Use message tags or OTN topics for messages outside the 24-hour window to avoid delivery restrictions.
• Limit multi-field update payloads to the documented maximums (for example, 20 fields per request).

Example use cases

• Send a welcome message or start a flow when a user subscribes using sendFlow or sendContent.
• Bulk-update customer phone or email custom fields after an import (ensure ManyChat permissions).
• Segment subscribers by adding/removing tags for targeted campaigns and automation triggers.
• Create and maintain bot-wide counters or flags using bot field create/set endpoints.
• Query page info, flows, and growth tools to build dashboards or automate content deployment.