# ChatSyncs

## Docs

- [ChatSyncs Documentation](https://docs.chatsyncs.com/index.md): Learn to automate WhatsApp with ChatSyncs — from the rules that keep your number alive to building your first bot, plus a full reference for the underlying Meta WhatsApp Cloud API.
- [Connect Account (Embedded) — the easy path](https://docs.chatsyncs.com/learn/connect-whatsapp-embedded.md): The near one-click way to link your WhatsApp number to ChatSyncs.
- [Connect Account (Manual) — the advanced path](https://docs.chatsyncs.com/learn/connect-whatsapp-manual.md): Link your WhatsApp number by hand when embedded signup won't work.
- [Tour of the ChatSyncs Dashboard](https://docs.chatsyncs.com/learn/dashboard-tour.md): Where everything lives, so the rest of the course can just say 'go to X'.
- [Set Up Your Meta Business Account for WhatsApp](https://docs.chatsyncs.com/learn/meta-account-setup.md): Create your business portfolio, add your number, and get production-ready access — the new Meta UI.
- [Welcome to ChatSyncs Mastery](https://docs.chatsyncs.com/learn/welcome.md): What this course covers, who it's for, and what you'll be able to build by the end.
- [AI Agent](https://docs.chatsyncs.com/learn/whatsapp-ai-agent.md): How to configure ChatSyncs's AI Agent in Bot Manager — train it on an AI Training Campaign, route messages with Intent Detection, choose between answering every query or only as a fallback, enable contextual memory, restrict topics like pricing, and set the AI reasoning level. Use when a customer as…
- [WhatsApp Business API Explained (And the Verification Myth)](https://docs.chatsyncs.com/learn/whatsapp-api-explained.md): What the API actually is, and why you can start messaging customers without verifying your business.
- [What WhatsApp API Pricing Really Means](https://docs.chatsyncs.com/learn/whatsapp-api-pricing.md): Why some messages are free and some cost money — the three conversation categories explained.
- [Bot Reply](https://docs.chatsyncs.com/learn/whatsapp-bot-reply.md): How to build an automated WhatsApp conversation in ChatSyncs's Bot Reply builder — trigger on keywords, collect answers into custom fields, forward data to a webhook or Google Sheets, and assemble the reply from 15+ flow components (buttons, lists, AI Reply, templates, and more). Use when a customer…
- [Broadcast Campaign](https://docs.chatsyncs.com/learn/whatsapp-broadcast-campaign.md): How to send one WhatsApp message to many subscribers at once with ChatSyncs's Broadcast Campaign — choosing 24 Hours vs Anytime, picking an approved template, targeting an audience by label/country/custom field, building the message as a flow, and reading delivery/open/unreached statistics. Use when…
- [Chat Widget](https://docs.chatsyncs.com/learn/whatsapp-chat-widget.md): How to add a WhatsApp chat widget to your website with ChatSyncs — configure its look and position, build its conversation as a flow, and deploy it with a JavaScript snippet, a WhatsApp short-link, or a QR code. Use when a customer asks how to put a WhatsApp button on their website, let site visitor…
- [WhatsApp Flows](https://docs.chatsyncs.com/learn/whatsapp-flows.md): How to build, configure, and publish a WhatsApp Flow — an in-chat form with components like Text Field, Checkbox Group, Radio Group, Select, Date Field, and Submit Button — including flow settings (name, category, reply after submit, HTTP API, Google Sheets), per-field options (Required, Label, Valu…
- [Input Flow](https://docs.chatsyncs.com/learn/whatsapp-input-flow.md): How to build a multi-question Input Flow that collects subscriber information automatically — naming the campaign, adding labels and webhook/Google Sheets integrations, choosing Free Keyboard Input or Multiple Choice questions, setting reply validation, saving responses to custom fields, and closing…
- [Message Templates](https://docs.chatsyncs.com/learn/whatsapp-message-templates.md): How to create, manage, and use WhatsApp message templates in ChatSyncs — the five template types (Mixed, WhatsApp, Carousel Media, Carousel Product, Default), custom fields and variables for personalization, AI Rewrite, and tracking approval status with Sync Template. Use when a customer asks how to…
- [Out-bound Webhook](https://docs.chatsyncs.com/learn/whatsapp-outbound-webhook.md): How to send data from ChatSyncs to an external app (Google Sheets, a CRM, Zapier, Make.com, Airtable, your own server) whenever a subscriber submits a WhatsApp Flow or Input Flow, clicks a Postback button, or shares their location — including a full walkthrough of wiring a Google Apps Script endpoin…
- [WhatsApp Rules: How to Never Get Banned](https://docs.chatsyncs.com/learn/whatsapp-rules-basics.md): The handful of rules that keep your business number alive — read this before you send anything.
- [Sequence](https://docs.chatsyncs.com/learn/whatsapp-sequence.md): How to automate a timed series of WhatsApp messages with ChatSyncs's Sequence feature — naming a sequence, setting delivery schedule and re-entry rules, choosing between a regular message (inside the 24-hour window) or a template message (anytime), and subscribing users to it from a Bot Reply flow.…
- [Subscriber Manager](https://docs.chatsyncs.com/learn/whatsapp-subscriber-manager.md): How to view, label, import, and bulk-manage your WhatsApp subscribers in ChatSyncs — the subscriber list, Labels, Custom Fields, importing contacts from a CSV/Google Sheet/Google Contacts, and bulk actions like Assign Label, Assign Sequence, and Delete Subscriber. Use when a customer asks how to see…
- [Access Tokens (Temporary vs Permanent)](https://docs.chatsyncs.com/meta-api/concepts/access-tokens.md): The difference between a temporary access token and a permanent system-user token in the WhatsApp Cloud API, and how to generate each. Use when a customer asks why their token expired, how to get a token that doesn't expire, or how to create a system user in Meta Business Manager.
- [Cloud API vs On-Premise](https://docs.chatsyncs.com/meta-api/concepts/cloud-vs-on-premise.md): What the WhatsApp Cloud API is and how it differs from the On-Premise API. Use when a customer asks whether they need their own server, whether to switch from On-Premise to Cloud API, or why On-Premise is no longer recommended.
- [Conversation Categories & Pricing](https://docs.chatsyncs.com/meta-api/concepts/conversation-categories-and-pricing.md): How WhatsApp Cloud API billing works — you pay per conversation (not per message), and there are four conversation types: Service, Marketing, Utility, and Authentication. Each type has different billing rules and different conditions that open it. Use when a customer asks how WhatsApp API billing wo…
- [WhatsApp Flows (Awareness)](https://docs.chatsyncs.com/meta-api/concepts/flows-awareness.md): Awareness-level overview of WhatsApp Flows — a Meta feature for building structured, form-like interactions within WhatsApp (collect inputs, show options, process responses). Use when a customer asks what WhatsApp Flows are, whether they can build a multi-step form on WhatsApp, or how Flows differ f…
- [How to Read the Meta Docs](https://docs.chatsyncs.com/meta-api/concepts/how-to-read-meta-docs.md): How to navigate the Meta developer documentation — the difference between Guide pages and Reference pages, how to read a reference page's parameters table, and where to find the API changelog. Use when a customer is confused about where to find API details, doesn't know the difference between a guid…
- [Media by URL vs Media ID](https://docs.chatsyncs.com/meta-api/concepts/media-by-url-vs-media-id.md): The two ways to attach a file (image, document, video, audio) to a WhatsApp Cloud API message — using a public URL or uploading the file to Meta first to get a media ID. Use when a customer asks how to send a file, why their image link isn't working, how to upload media, or which method to use for t…
- [Messaging Limits & Quality Rating](https://docs.chatsyncs.com/meta-api/concepts/messaging-limits-and-quality-rating.md): How WhatsApp Cloud API messaging limits work — the daily cap on business-initiated conversations — and how quality rating (green/yellow/red) affects whether your limit scales up or gets reduced. Use when a customer asks why they can only message 250 people per day, how to increase their messaging li…
- [Meta Developer Account Setup](https://docs.chatsyncs.com/meta-api/concepts/meta-developer-account-setup.md): How to create a Meta developer account, create a WhatsApp app, and get a test phone number with a Phone Number ID. Use when a customer asks how to get started with the WhatsApp Cloud API, where to create their app, or how to find their test number and IDs in the Meta dashboard.
- [Request Anatomy & API Versioning](https://docs.chatsyncs.com/meta-api/concepts/request-anatomy-and-versioning.md): The four parts of every WhatsApp Cloud API HTTP request — endpoint, headers, body, and response — and how Meta's API versioning (v21.0, v24.0, etc.) works. Use when a customer asks what the URL structure means, what headers are required, what the version number in the URL does, or what happens when…
- [WhatsApp API Glossary (WABA, Phone Number ID, BSP)](https://docs.chatsyncs.com/meta-api/concepts/whatsapp-api-glossary.md): Definitions of the key WhatsApp Business API terms — WABA, Phone Number ID, WABA ID, and BSP. Use when a customer asks what any of these terms mean, or is confused by the jargon in the Meta developer dashboard.
- [The 24-Hour Customer Service Window](https://docs.chatsyncs.com/meta-api/messaging/24-hour-customer-service-window.md): The 24-hour customer service window in the WhatsApp Cloud API — what it is, how the rolling timer works, what you can send inside vs outside the window, and how to reach a customer when the window is closed. Use when a customer asks why their message failed after 24 hours, why they can only send tem…
- [Audio Messages](https://docs.chatsyncs.com/meta-api/messaging/audio-messages.md): How to send an audio message or voice note on the WhatsApp Cloud API, including supported formats and size limits. Use when a customer asks how to send audio or a voice note on WhatsApp API, what audio formats are supported, or why their audio file isn't sending.
- [Contact Messages](https://docs.chatsyncs.com/meta-api/messaging/contact-messages.md): How to send a contact card message on the WhatsApp Cloud API, sharing a person's name, phone number, email, and other vCard details. Use when a customer asks how to share a contact on WhatsApp API or how to send a vCard.
- [CTA URL Buttons](https://docs.chatsyncs.com/meta-api/messaging/cta-url-buttons.md): How to send an interactive CTA (Call-to-Action) URL button message on the WhatsApp Cloud API — a button that opens a website when tapped. Use when a customer asks how to add a link button to a WhatsApp message, how to send a 'Visit Website' button, or how to link to a payment page or product URL.
- [Document Messages](https://docs.chatsyncs.com/meta-api/messaging/document-messages.md): How to send a document (PDF, Word, Excel, PowerPoint, or text file) on the WhatsApp Cloud API using a URL or media ID, including the filename and caption fields. Use when a customer asks how to send a file or PDF on WhatsApp API, what document formats are supported, or how to control the filename sh…
- [Image Messages](https://docs.chatsyncs.com/meta-api/messaging/image-messages.md): How to send an image message on the WhatsApp Cloud API, including supported formats, file size limits, captions, and whether to use a URL or media ID. Use when a customer asks how to send an image or photo on WhatsApp API, why their image isn't sending, or what image formats are supported.
- [List Messages](https://docs.chatsyncs.com/meta-api/messaging/list-messages.md): How to send an interactive list message on the WhatsApp Cloud API — a menu with sections and up to 10 selectable rows. Use when a customer asks how to send a menu or list of options on WhatsApp, or when they need more than 3 choices (beyond what reply buttons support).
- [Location Messages](https://docs.chatsyncs.com/meta-api/messaging/location-messages.md): How to send a location message on the WhatsApp Cloud API using latitude, longitude, name, and address fields. Use when a customer asks how to share a location or map pin on WhatsApp API, or how to send a business address to a customer.
- [Media API (Upload, Retrieve, Delete)](https://docs.chatsyncs.com/meta-api/messaging/media-api.md): How to upload, retrieve, and delete media files using the WhatsApp Cloud API Media endpoint — getting a media ID for use in messages, downloading a media file from a received message, and deleting uploaded media. Use when a customer asks how to upload a file before sending it, how to download media…
- [Reactions](https://docs.chatsyncs.com/meta-api/messaging/reactions.md): How to send a reaction (emoji) to a specific WhatsApp message using the WhatsApp Cloud API, and how to remove a reaction. Use when a customer asks how to react to a message with an emoji, or how to remove an existing reaction.
- [Replies (Quoting)](https://docs.chatsyncs.com/meta-api/messaging/replies-quoting.md): How to send a reply that quotes a specific previous WhatsApp message using the context field with a message_id. Use when a customer asks how to reply to a specific message, how to quote a message in a response, or how to use the context field in the WhatsApp API.
- [Reply Buttons (Quick Replies)](https://docs.chatsyncs.com/meta-api/messaging/reply-buttons.md): How to send an interactive message with up to 3 tappable reply buttons (quick replies) on the WhatsApp Cloud API. Use when a customer asks how to add buttons to a WhatsApp message, how to send quick reply options, or how to build a simple yes/no or multiple-choice interaction.
- [Sending Your First Message](https://docs.chatsyncs.com/meta-api/messaging/sending-first-message.md): How to send the first test message using the pre-approved hello_world template on the WhatsApp Cloud API. Use when a customer has just set up their Meta app and wants to verify the API is working, or asks how to send a message when there is no existing conversation with the recipient.
- [Sending Text Messages](https://docs.chatsyncs.com/meta-api/messaging/sending-text-messages.md): How to send a plain text message on the WhatsApp Cloud API, with or without URL preview. Use when a customer asks how to send a normal text reply, why their link isn't showing a preview card, why free text only works inside the 24-hour window, or why a text message failed.
- [Sticker Messages](https://docs.chatsyncs.com/meta-api/messaging/sticker-messages.md): How to send a sticker message on the WhatsApp Cloud API, including the WebP format requirement and size limits for static and animated stickers. Use when a customer asks how to send a sticker on WhatsApp API or why their sticker isn't sending.
- [Video Messages](https://docs.chatsyncs.com/meta-api/messaging/video-messages.md): How to send a video message on the WhatsApp Cloud API, including supported formats, file size limits, and captions. Use when a customer asks how to send a video on WhatsApp API, what video formats are supported, or why their video isn't sending.
- [Template Approval & Rejections](https://docs.chatsyncs.com/meta-api/templates/template-approval-and-rejections.md): What Meta checks when reviewing a template submission and the most common reasons templates get rejected — wrong category, non-sequential variable numbers, policy violations (spam, misleading claims, adult content, impersonation), or broken button URLs. Use when a customer asks why their template wa…
- [Template Categories](https://docs.chatsyncs.com/meta-api/templates/template-categories.md): The three WhatsApp template categories — Marketing, Utility, and Authentication — what each is for, when to use each, and the key rules per category. Use when a customer asks what type of template to create, why their template was reclassified, what an authentication template is for, or why marketin…
- [Template Structure & Sending](https://docs.chatsyncs.com/meta-api/templates/template-structure-and-sending.md): How a WhatsApp template message is structured (header, body, footer, buttons) and how to send one via the API using the components array. Use when a customer asks how to send a template message, what the components field is, how to include a header image or footer text, or what the full API payload…
- [Template Variables & Parameters](https://docs.chatsyncs.com/meta-api/templates/template-variables-and-parameters.md): How WhatsApp template variables ({{1}}, {{2}}, etc.) work and how parameters in the API call fill them in with real values. Use when a customer asks how to personalize a template with a customer name, order number, or other dynamic value, what {{1}} means inside a template, or how to send different…
- [Why Templates Exist](https://docs.chatsyncs.com/meta-api/templates/why-templates-exist.md): Why WhatsApp requires pre-approved message templates for businesses — the spam prevention rule that stops businesses from freely messaging customers anytime. Use when a customer asks why they need to create a template, why they can't just send any message they want, or why Meta must approve their me…
- [Error Handling & Codes](https://docs.chatsyncs.com/meta-api/webhooks/error-handling-and-codes.md): How to handle errors from the WhatsApp Cloud API and what the most common error codes mean — 190 (token expired), 131030 (test recipient not added), 131047 (24-hour window closed), 131049 (marketing message blocked), 131026 (number has no WhatsApp). Use when a customer asks why their message send fa…
- [Full Round Trip](https://docs.chatsyncs.com/meta-api/webhooks/full-round-trip.md): The complete lifecycle of one WhatsApp bot interaction — inbound message arrives at webhook, logic decides the reply, outbound message sent via API, status events confirm delivery. Use when a customer asks how the whole bot flow works end to end, or wants to understand the sequence from customer mes…
- [Parsing Inbound Payloads](https://docs.chatsyncs.com/meta-api/webhooks/parsing-inbound-payloads.md): How to read and parse the JSON payload Meta sends to your webhook for different inbound message types — text, image, video, audio, document, and interactive (button/list reply). Use when a customer asks how to read an incoming message, how to get the text a customer sent, how to get a media ID from…
- [Status Webhooks](https://docs.chatsyncs.com/meta-api/webhooks/status-webhooks.md): The four delivery status events Meta sends to your webhook after you send a message — sent, delivered, read, and failed — what each means and how to parse them. Use when a customer asks how to know if their message was delivered, how to track read receipts, why a message shows as failed, or what the…
- [Subscribe WABA Webhook](https://docs.chatsyncs.com/meta-api/webhooks/subscribe-waba-webhook.md): How to subscribe to webhook fields on a WhatsApp Business Account (WABA) so Meta starts delivering inbound messages to your endpoint, and what the first inbound message flow looks like end to end. Use when a customer asks how to start receiving WhatsApp messages on their server, why their webhook is…
- [Webhook Endpoint Setup](https://docs.chatsyncs.com/meta-api/webhooks/webhook-endpoint-setup.md): How to set up a webhook endpoint for the WhatsApp Cloud API and what the Meta verification handshake is — Meta sends a GET request to your URL with a challenge, your server must echo it back to prove ownership. Use when a customer asks how to register a webhook, what the verify token is, why Meta sa…
- [Webhook Reliability](https://docs.chatsyncs.com/meta-api/webhooks/webhook-reliability.md): Three rules for reliable WhatsApp webhook handling — always respond 200 immediately, expect duplicate deliveries and deduplicate by message ID, and don't assume messages arrive in order. Use when a customer asks why they receive duplicate messages, why their webhook is getting retried, or how to mak…
- [Webhooks — What and Why](https://docs.chatsyncs.com/meta-api/webhooks/webhooks-what-and-why.md): What WhatsApp webhooks are and why you need them — Meta's server sends JSON notifications to your endpoint whenever something happens (incoming message, delivery receipt, template status change). Use when a customer asks what a webhook is, how to receive incoming WhatsApp messages, how to know if a…