Synergy Connect integration
Synergy Connect (G2N Tech, Brazil) is a WhatsApp platform built on Meta's official WhatsApp Cloud API: its public API keeps the Cloud API contract for sending and media and adds its own routes. Send WhatsApp messages (text, media, interactive, approved templates) and mark them read, send Instagram direct messages, upload, read, download and delete media, manage message templates, read the shared inbox (conversations, messages, contacts, ad clicks; personal data), hand conversations to human agents, start Journeys, issue WhatsApp Flow tokens, create hosted links where your clients connect their own numbers, and manage webhooks (health, stats, retry, replay, test). Rotating a webhook signing secret is left out (its answer is the secret), and so are custom webhook delivery headers (they usually carry credentials). Authentication: an API key an organization admin creates in the Synergy app (Settings, API and webhooks, API keys), sent as Authorization: Bearer. Its scopes (messages, management, read, onboarding) decide which tools work; reading the inbox and handing over also need the Inbox plan feature.
Say what should happen.
The workflow builds itself.
What you can do with Synergy Connect
Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.
Each badge shows the default agent permission of an endpoint (allowed: an agent calls it without asking; ask first: you are asked before an agent calls it, when the agent or chat asks permission for sensitive actions; never: no agent may call it), which every user can change endpoint by endpoint in their credential settings.
Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.
Webhook, 7 operations
create_webhookCreate webhookPOSTAgents: ask firstRegister an HTTPS URL to receive WhatsApp and Instagram events for some of your numbers. The URL must first answer Synergy's signed test POST with 2xx within 5 s (or Meta's hub.challenge). Up to 20 per organization.delete_webhookDelete webhookDELETEAgents: ask firstDelete a webhook: deliveries stop and its pending queue is dropped on every number.list_webhooksList webhooksGETAgents: ask firstList the organization's webhooks this key can see, newest first: id, URL, events, status filter, numbers covered, enabled, verification mode, custom header names and why it was disabled. Secrets and header values are never returned.replay_webhookReplay webhookPOSTAgents: ask firstQueue again the events each number stored since a time, through the webhook's current filter and with their original delivery ids, so they are delivered again. Up to 30 days back (7 for statuses), 5,000 per number.retry_webhookRetry webhookPOSTAgents: ask firstMake every number with queued events for this webhook retry delivery now instead of waiting (after your receiver is fixed). Numbers where it is suspended do not retry: reactivate with update_webhook (enabled true).test_webhookTest webhookPOSTAgents: ask firstSend one real, signed sample messages event to the webhook URL now (even if disabled or not subscribed to messages) to check your receiver. One attempt, delivery id test-<uuid>.update_webhookUpdate webhookPATCHAgents: ask firstChange only the webhook fields you send (at least one). Any change resets its health on every number, so enabled true reactivates a suspended webhook. A new URL or verification mode is verified again first.
Message template, 5 operations
create_templateCreate templatePOSTAgents: ask firstCreate a message template on the number's WhatsApp Business account and submit it to Meta; it starts PENDING until Meta reviews it. Upload header sample media first with upload_template_media.delete_templateDelete templateDELETEAgents: ask firstDelete a message template at Meta, by id; only a template of this number's WhatsApp Business account is deleted. Answers success true.get_templateGet templateGETAgents: ask firstGet one message template of the number's WhatsApp Business account by id: name, language, status at Meta, category, parameter format and components.list_templatesList templatesGETAgents: ask firstList the message templates of a number's WhatsApp Business account from Synergy's cache. syncing true means a refresh started: call again in a few seconds. Filters: status (default APPROVED), name prefix, language.update_templateUpdate templatePOSTAgents: ask firstEdit a message template's components (and optionally its category or message TTL); Meta reviews it again. components replaces the current list: read it with get_template and send every component to keep.
Media, 4 operations
delete_mediaDelete mediaDELETEAgents: ask firstDelete a media file of a number at Meta, by media id. Only media of that number is deleted; any other id answers 404 and nothing is deleted.download_mediaDownload mediaGETAgents: ask firstDownload the file of a media item a number received or sent and store it as a file. A customer's file is personal content.get_mediaGet mediaGETAgents: ask firstGet a media file of a number (received or sent) by media id: MIME type, size, SHA-256 and a download URL on this API. Get the file itself with download_media.upload_mediaUpload mediaPOSTAgents: ask firstUpload a file to Meta for one number and get the media id to send it with send_whatsapp_message (image.id, document.id...). Whole request up to 16 MB; the id works for this number for 30 days.
Conversation, 3 operations
handoff_conversationHandoff conversationPOSTAgents: ask firstHand a customer's conversation held by this key's automation to the human agents' queue (status pending); a notice appears in the platform. Changes who answers the customer. Needs the Inbox plan feature.list_conversationsList conversationsGETAgents: ask firstList the conversations of a number, newest first: contact name and WhatsApp id, status, unread count, owning automation, 24-hour window end, last message preview and ad attribution. Personal data; page with after.search_conversationsSearch conversationsPOSTAgents: ask firstSearch the conversations of a number by phone digits (5 or more, a prefix of the WhatsApp id) or part of the contact name, optionally by status. Personal data; page with after.
Onboarding session, 3 operations
cancel_onboarding_sessionCancel onboarding sessionPOSTAgents: ask firstCancel an onboarding session so its link stops working. Cancelling again returns the same session; a completed session (number already connected) cannot be cancelled and answers 409.create_onboarding_sessionCreate onboarding sessionPOSTAgents: ask firstCreate a single-use hosted signup link where your own client connects their WhatsApp number to your organization (Meta Embedded Signup); send the client's browser to url. Needs a paid plan with the API feature.get_onboarding_sessionGet onboarding sessionGETAgents: ask firstGet an onboarding session: status (pending, opened, completed, expired, cancelled, blocked), state, the link while pending, why it is blocked or failed, and once completed the connected number. Check state here before granting access.
Whatsapp message, 2 operations
mark_message_as_readMark message as readPOSTAgents: ask firstMark a WhatsApp message a customer sent as read (blue ticks for the customer) and optionally show a typing indicator until your next message, for up to 25 seconds. Answers success true.send_whatsapp_messageSend whatsapp messagePOSTAgents: ask firstSend a WhatsApp message from one of your numbers to a real person or group: text, image, audio, video, document, sticker, location, contacts, reaction, interactive or an approved template. Set type and the matching object.
Ad referral, 1 operation
list_ad_referralsList ad referralsGETAgents: ask firstList ad clicks that opened or reopened a conversation on a number, newest first: conversation, WhatsApp id, ad, ad set and campaign, ad text and media, and whether the click is attributable. Filter by time or ad_id.
Api key, 1 operation
get_api_key_infoGet api key infoGETAgents: ask firstGet the API key in use: id, name, last 4 characters, scopes, mode (notify or bot), origin, the numbers it reaches and assistant limits, plus the organization id and which plan features are on. Works with any scope.
Contact, 1 operation
search_contactsSearch contactsPOSTAgents: ask firstSearch the contacts of a number by phone digits (a prefix of the WhatsApp id) or part of the name. Returns personal data: name, phone, WhatsApp id, last message time. Page with after.
Conversation change, 1 operation
list_conversation_changesList conversation changesGETAgents: ask firstList the conversations of a number that changed since a revision (since = rev of the previous answer; up to 50) and the ids that left. reset true (since 0 or stale) means data holds the unread conversations not held by automation.
Flow token, 1 operation
create_flow_tokenCreate flow tokenPOSTAgents: ask firstIssue the flow_token needed to send a WhatsApp Flow whose endpoint Synergy hosts, for one number, flow and recipient (valid 3 days). Then send the flow with send_whatsapp_message. Creates the contact if new.
Instagram message, 1 operation
send_instagram_messageSend instagram messagePOSTAgents: ask firstSend an Instagram direct message from a connected Instagram account to a person (IGSID) who already has a conversation with it, inside the 24-hour window, or a private reply to a comment (queued). Sends to a real person.
Journey, 1 operation
list_journeysList journeysGETAgents: ask firstList the active Journeys (automated conversation flows) of a WhatsApp number or Instagram account: id, name and trigger. Only Journeys with trigger api can be started with start_journey_run.
Journey run, 1 operation
start_journey_runStart journey runPOSTAgents: ask firstStart an active Journey with trigger api for one person who already has a conversation with the account; its blocks then send them messages. Needs a unique Idempotency-Key. Answers the run id (202).
Message, 1 operation
list_conversation_messagesList conversation messagesGETAgents: ask firstList the messages of one conversation, newest first: wamid, direction, author, time, status, Meta type and the message object. Media comes as an id only. Personal data; page with before.
Phone number, 1 operation
list_numbersList numbersGETAgents: ask firstList the WhatsApp numbers this API key can reach (Instagram accounts are not listed): Meta phone_number_id (used by the other tools), Synergy number id (used in webhook instanceIds), display number, verified name, mode and status.
Template media, 1 operation
upload_template_mediaUpload template mediaPOSTAgents: ask firstUpload the sample image, video or PDF a media template header needs for Meta's review (JPEG, PNG, MP4 or PDF, up to 5 MB) and get the handle to put in the header's example.header_handle in create_template.
Webhook health, 1 operation
get_webhook_healthGet webhook healthGETAgents: ask firstGet the delivery health of each webhook, keyed by webhook id and summed across numbers: state healthy, degraded (failing, events queued and retried) or suspended (queue dropped), queued and dropped counts, last error.
Webhook stats, 1 operation
get_webhook_statsGet webhook statsGETAgents: ask firstGet deliveries, failures, timeouts, average latency and last success per webhook (keyed by webhook id) over the last 24 hours, or 7 days with hours 168. available false means metrics could not be read.
Use Synergy Connect from Claude Code, Cursor or Codex
Connect Synergy Connect in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Synergy Connect operations become tools the client can call, next to every other integration you connected.
claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"
[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"{
"mcpServers": {
"livecontext": {
"type": "http",
"url": "https://livecontext.ai/mcp",
"headers": {
"X-API-Key": "YOUR_API_KEY"
}
}
}
}How to connect Synergy Connect
- Create your workspace
Sign up free. Nothing to install.
- Connect Synergy Connect once
Add your Synergy Connect connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
- Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.
Synergy Connect integration FAQ
What can you do with the Synergy Connect integration?
LiveContext exposes 37 operations on Synergy Connect, covering webhook, message template, media and conversation.
