For Agents
Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Documentation MegaAPI, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | shStep 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with Documentation MegaAPI API.
Send text, media, location, link-preview, list, and contact messages to WhatsApp users via /rest/sendMessage endpoints
Provision and manage WhatsApp instances with QR code and pairing-code login flows
Configure webhooks per instance to receive incoming messages and event notifications
GET STARTED
Send WhatsApp messages, manage instances and groups, and receive webhook events for unofficial WhatsApp automation in Brazil.
Use for: Send a WhatsApp text message to a customer, Forward a WhatsApp media file via URL or base64 payload, Get the QR code to log a WhatsApp instance in, Configure a webhook for a MegaAPI instance
Not supported: Does not handle official WhatsApp Business Platform template review, voice or video calling, or SMS/email channels — use for unofficial WhatsApp messaging and instance management only.
Jentic publishes the only available OpenAPI specification for Documentation MegaAPI, keeping it validated and agent-ready. MegaAPI is a Brazilian unofficial WhatsApp gateway that lets developers run WhatsApp instances, scan QR codes, and send text, media, location, list, and contact messages programmatically. The API also covers webhook configuration, group management, and chat presence updates, so integrators can build full conversational experiences without using the official WhatsApp Business Platform. It is widely used in Brazil for SME customer support, e-commerce notifications, and chatbot deployment.
Manage WhatsApp groups, list members, and inspect group metadata
Update chat presence (typing, recording) and delete messages from a conversation
Patterns agents use Documentation MegaAPI API for, with concrete tasks.
★ Brazilian E-commerce Order Notifications
Brazilian Shopify and Tray storefronts send WhatsApp order confirmations, shipping updates, and abandoned-cart reminders through MegaAPI without subscribing to the official WhatsApp Business Platform. POST /rest/sendMessage/{instance_key}/text dispatches the message and the configured webhook captures the customer reply for the support agent to pick up.
Send a WhatsApp text message to the customer's number with the order tracking link via POST /rest/sendMessage/{instance_key}/text using the active instance's bearer token.
Customer Support Chatbot
Customer-support teams deploy a chatbot on a MegaAPI instance to triage incoming WhatsApp messages, send template responses, and escalate to a human when needed. The webhook configured via POST /rest/webhook/{instance_key}/configWebhook delivers each inbound message in real time, while POST /rest/sendMessage/{instance_key}/listMessage offers a structured menu reply.
Configure a webhook for the support instance, then on each inbound event send a list message back to the customer with the available support categories.
Group Broadcast and Community Management
Community managers running paid WhatsApp groups use MegaAPI to enumerate group membership, broadcast announcements, and remove off-topic messages. GET /rest/group/list/{instance_key} returns the group inventory and POST /rest/sendMessage endpoints push the announcement, with delete-message operations available to clean up.
List all groups on an instance, pick the target group by name, and send a broadcast text message to it via POST /rest/sendMessage/{instance_key}/text.
AI Agent WhatsApp Outbound
An AI agent running an outreach workflow can use Jentic to dispatch WhatsApp messages through MegaAPI without managing instance lifecycle, QR-code login, or webhook reconnection. Jentic surfaces the send-message and instance-status operations by intent, so the agent only has to choose the right message type and pass the recipient.
Search Jentic for 'send a WhatsApp text message', load the POST /rest/sendMessage/{instance_key}/text schema, and execute it with the customer phone number and message body.
29 endpoints — jentic publishes the only available openapi specification for documentation megaapi, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/rest/sendMessage/{instance_key}/text
Send a WhatsApp text message to a user.
/rest/sendMessage/{instance_key}/mediaUrl
Send a media message via a hosted URL.
/rest/sendMessage/{instance_key}/listMessage
Send a structured list message for chatbot menus.
/rest/instance/{instance_key}
Check the status of a WhatsApp instance.
/rest/instance/qrcode/{instance_key}
Fetch the QR code for instance login.
/rest/webhook/{instance_key}/configWebhook
Configure the inbound webhook URL for an instance.
/rest/group/list/{instance_key}
List all WhatsApp groups for an instance.
/rest/instance/isOnWhatsApp/{instance_key}
Check whether a phone number is registered on WhatsApp.
/rest/sendMessage/{instance_key}/text
Send a WhatsApp text message to a user.
/rest/sendMessage/{instance_key}/mediaUrl
Send a media message via a hosted URL.
/rest/sendMessage/{instance_key}/listMessage
Send a structured list message for chatbot menus.
/rest/instance/{instance_key}
Check the status of a WhatsApp instance.
/rest/instance/qrcode/{instance_key}
Fetch the QR code for instance login.
Three things that make agents converge on Jentic-routed access.
Credential isolation
MegaAPI bearer tokens are stored in the encrypted Jentic vault (MAXsystem). Agents receive scoped access tokens — the raw bearer key never enters the agent's context or appears in logs.
Intent-based discovery
Agents search Jentic by intent (e.g., 'send a WhatsApp text message') and receive the matching MegaAPI operation with its input schema, so they can call the right endpoint without browsing the MegaAPI documentation site.
Time to first call
Direct MegaAPI integration: 2-3 days for instance lifecycle, QR-code login, and webhook handling. Through Jentic: under 1 hour — search, load schema, execute against an existing instance.
Alternatives and complements available in the Jentic catalogue.
Specific to using Documentation MegaAPI API through Jentic.
Why is there no official OpenAPI spec for Documentation MegaAPI?
MegaAPI does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Documentation MegaAPI via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.
What authentication does the MegaAPI use?
MegaAPI uses HTTP Bearer authentication. Pass an Authorization: Bearer <token> header on every request, where the token is the API key associated with your MegaAPI account. Through Jentic the bearer token is stored encrypted and injected at call time, so it never enters the agent's prompt context.
Can I send media files larger than the WhatsApp limit?
MegaAPI exposes two media-send paths — POST /rest/sendMessage/{instance_key}/mediaUrl for hosted files and POST /rest/sendMessage/{instance_key}/mediaBase64 for in-line base64 — but the underlying WhatsApp transport still enforces the standard 16 MB media size cap. For larger files, host them externally and send the link with POST /rest/sendMessage/{instance_key}/sendLinkPreview instead.
What are the rate limits for MegaAPI?
Rate limits are not declared in the OpenAPI spec and are governed by your MegaAPI plan and by WhatsApp's own anti-spam thresholds. As an unofficial gateway the practical guidance is to keep outbound throughput conservative — bursts of broadcast traffic are the most common cause of instance bans.
How do I send a WhatsApp text message through Jentic?
Run pip install jentic, then search Jentic for 'send a WhatsApp text message', load the schema for POST /rest/sendMessage/{instance_key}/text, and execute it with the instance_key, recipient phone number, and message body. Jentic injects the bearer token from your stored credentials. Sign up at https://app.jentic.com/sign-up.
How do I receive incoming WhatsApp messages?
Configure a webhook on your instance with POST /rest/webhook/{instance_key}/configWebhook, pointing at an endpoint you control. MegaAPI then POSTs every inbound message and event to that URL. You can read or update the current webhook config at any time via GET /rest/webhook/{instance_key}.
/rest/webhook/{instance_key}/configWebhook
Configure the inbound webhook URL for an instance.
/rest/group/list/{instance_key}
List all WhatsApp groups for an instance.
/rest/instance/isOnWhatsApp/{instance_key}
Check whether a phone number is registered on WhatsApp.