# Introduction of integration ### How Integration with Whapi.Cloud Works Whapi.Cloud is a REST API. This means any service, platform, or programming language that can send HTTP requests and receive webhooks can be integrated with WhatsApp through our gateway. No special SDK, plugin, or connector is required. ### The Event → Reaction Pattern Every integration with Whapi.Cloud follows the same principle: **event → reaction**. **Events** are things that happen on WhatsApp — a new incoming message, a status update, a group change, a new call. When an event occurs, Whapi.Cloud instantly sends an HTTP POST request (a webhook) to the URL you specify in your channel settings. Your server or automation platform receives this request and can react to it however you need. **Reactions** are the actions your system takes in response — sending a reply, updating a CRM record, forwarding the message to a helpdesk, logging the data, or anything else. To perform actions on WhatsApp (send a message, create a group, update a status), your system sends an HTTP request to the Whapi.Cloud API. That's it. Webhook in, API request out. Everything else is your business logic in between. ### What You Need to Get Started 1. A [Whapi.Cloud account](https://panel.whapi.cloud/) with a connected WhatsApp number and an API token 2. A webhook URL — a publicly accessible endpoint on your server or no-code platform that will receive incoming events 3. The ability to send HTTP requests — from your code, a no-code tool, or any HTTP client Set the webhook URL in your channel settings, enable the events you want to track, and you're ready to go. Full setup guide: [Where to find the webhook URL](https://support.whapi.cloud/help-desk/receiving/webhooks/where-to-find-the-webhook-url) ### What Events Can You Track? Whapi.Cloud can notify you about a wide range of WhatsApp events: * **Messages** — new message, edited message, deleted message * **Statuses** — message delivered, read, sent * **Chats** — new chat, chat updated, chat removed * **Groups** — new group, participants joined/left, group settings changed * **Calls** — incoming and outgoing call events * **Contacts** — contact updated * **Labels** — label added or removed * **Channel status** — QR code updates, connection/disconnection You choose which events to enable in your channel settings. For a detailed description of all webhook events and their JSON format, see: [Tracked events](https://support.whapi.cloud/help-desk/receiving/webhooks/our-webhooks-tracked-events) ### Two Ways to Build an Integration **With code.** Write a backend in any language — Python, Node.js, PHP, Java, Go, C#. Your server listens for webhooks and calls the Whapi.Cloud API. We have ready-made bot templates on GitHub to get you started: [github.com/Whapi-Cloud](https://github.com/Whapi-Cloud) **Without code.** Use a visual automation platform that supports HTTP requests and webhooks. We have native integrations with: * [Make](https://support.whapi.cloud/help-desk/integrations/make.com) (ex. Integromat) — Whapi.Cloud app available in the marketplace * [n8n](https://support.whapi.cloud/help-desk/integrations/n8n) — custom node for self-hosted n8n, or HTTP requests for n8n Cloud Any other platform — Zapier, Albato, Bubble, Lovable, or others — can connect to Whapi.Cloud using its built-in HTTP Request and Webhook modules. The logic is always the same: receive events via webhook, send actions via API. ### Example: Simple Auto-Reply Flow 1. A customer sends a message to your WhatsApp number 2. Whapi.Cloud delivers the message to your webhook URL as a JSON payload 3. Your server (or no-code scenario) reads the message text and decides on a reply 4. Your system sends a POST request to `https://gate.whapi.cloud/messages/text` with the reply — and the customer receives it instantly This same pattern scales to any complexity: routing messages to different departments, syncing with a database, triggering workflows in your CRM, and more. ### How to Build an AI-Powered WhatsApp Chatbot You can build an intelligent WhatsApp chatbot that uses AI (such as OpenAI ChatGPT, Anthropic Claude, Google Gemini, or any other LLM) to understand and respond to user messages. Whapi.Cloud acts as the WhatsApp transport layer — it receives messages from users and sends replies back — while the AI model handles the conversation logic. #### How It Works The architecture is straightforward: 1. A customer sends a message to your WhatsApp number 2. Whapi.Cloud delivers it to your server or automation platform via webhook 3. Your application forwards the message text to an AI model (e.g. OpenAI API) 4. The AI model generates a response 5. Your application sends the response back to the customer via the Whapi.Cloud API Whapi.Cloud doesn't limit which AI provider you use. Any service with an HTTP API works — OpenAI, Anthropic, Google AI, Mistral, a self-hosted model, or anything else. #### What You Can Build An AI-powered WhatsApp bot can cover a wide range of business tasks: * **Customer support** — answer FAQs, troubleshoot issues, guide users through your product, and escalate complex cases to a human agent * **Sales assistant** — qualify leads, recommend products based on customer preferences, send pricing and availability, and collect orders directly in the chat * **Appointment booking** — let customers schedule, reschedule, or cancel appointments through a natural conversation * **HR & internal helpdesk** — answer employee questions about policies, vacation days, onboarding steps, or IT requests * **E-commerce order management** — send order confirmations, delivery updates, and handle returns or refund requests automatically * **Education & tutoring** — provide learning materials, answer student questions, and send reminders about classes or deadlines * **Real estate** — respond to property inquiries, share listings, schedule viewings, and follow up with potential buyers * **Healthcare** — send appointment reminders, answer general medical questions, and notify patients when test results are ready * Hospitality & travel — confirm reservations, share check-in details, answer questions about amenities, and collect guest feedback In each case, the AI model handles the conversation, while Whapi.Cloud takes care of message delivery and receiving — so you focus on business logic, not WhatsApp infrastructure.
Need help with a specific platform or use case? Contact our support team — we're happy to help you get set up.