> ## Documentation Index > Fetch the complete documentation index at: https://docs.antryk.com/llms.txt > Use this file to discover all available pages before exploring further. # WhatsApp Services > Build scalable WhatsApp messaging and customer communication workflows with Antryk WhatsApp Services. Send notifications, media, interactive messages, and automated conversations with two-way messaging, webhook integration, and real-time delivery tracking. Antryk WhatsApp Services provides programmable WhatsApp messaging infrastructure for notifications, automated support, and interactive customer conversations through APIs and a unified dashboard. Connect your business WhatsApp number, manage conversations, send rich messages and media, receive incoming messages, configure webhooks, and monitor message delivery in real time. Antryk integrates with the official WhatsApp Business API to provide reliable business messaging workflows with high deliverability, opt-in management, delivery tracking, and read receipts. *** ## What are WhatsApp Services? WhatsApp Services in Antryk allow businesses and developers to connect their WhatsApp Business numbers and manage customer communication from a centralized platform. Each connected business WhatsApp number becomes a dedicated WhatsApp service that can be used for: * Customer notifications * Automated customer support * Two-way conversations * Order and transaction updates * Customer service communication * Interactive messaging * Media and document sharing * API-based WhatsApp messaging * Webhook-driven automation Antryk combines WhatsApp APIs, webhooks, message logs, delivery tracking, and an inbox into one platform for managing business WhatsApp communication. *** ## WhatsApp Messaging Features Antryk WhatsApp Services are designed for businesses that need reliable and programmable customer communication. ### Core Features * Official WhatsApp Business API integration * Programmable WhatsApp messaging * Image, video, audio, and document support * Quick replies and interactive messages * Two-way customer messaging * Webhook integration * Real-time delivery tracking * Message delivery and read receipts * Centralized WhatsApp inbox * Message and webhook audit logs * API-based messaging * Business WhatsApp number management *** ## Common WhatsApp Use Cases WhatsApp can be used across customer engagement, transactional communication, and support workflows. ### Customer Notifications Send timely notifications to customers when important business events occur. Common examples include: * Order confirmations * Shipping updates * Delivery notifications * Appointment reminders * Payment notifications * Account alerts * Service notifications * Booking confirmations *** ## WhatsApp Business Integration Antryk allows businesses to configure their WhatsApp Business number directly from the dashboard. The **Connect WhatsApp** workflow allows you to add a new WhatsApp Business service and configure the required business WhatsApp details. Once connected, the WhatsApp service becomes available from the WhatsApp Services listing page. connect whatsapp button *** ## WhatsApp Services Listing Page Whatsapp Service Listing Page The WhatsApp Services listing page displays all WhatsApp Business numbers configured in your Antryk account. The page provides a centralized view of your connected WhatsApp services and their synchronization information. ### Information Displayed | Column | Description | | --------------- | ----------------------------------------------- | | Business Name | Name of the connected WhatsApp Business account | | WhatsApp Number | Business WhatsApp phone number | | WABA ID | WhatsApp Business Account identifier | | Phone Number ID | WhatsApp Business phone number identifier | | Sync | Current synchronization state | Clicking a WhatsApp service opens its dedicated service dashboard. From the service detail page, you can access: * Overview * Webhook Logs * Message Logs * Inbox *** ## Connect WhatsApp To configure a new WhatsApp Business service, click **Connect WhatsApp** from the WhatsApp Services listing page. The connection workflow allows you to enter the required WhatsApp Business details and configure a new service. ### Connection Workflow 1. Open the **WhatsApp Services** dashboard. 2. Click **Connect WhatsApp**. 3. Enter the required WhatsApp Business details. 4. Complete the WhatsApp Business configuration. 5. Start the synchronization process. 6. Wait for the synchronization status to become **Completed**. 7. Open the newly configured WhatsApp service. Once synchronization is complete, the business WhatsApp number can be managed from its service detail page. *** ## WhatsApp Service Overview Whatsapp Service Overview Page The WhatsApp service overview provides the main configuration and synchronization information for your connected business WhatsApp number. ### Overview Information | Field | Description | | ------------------ | ----------------------------------------------- | | Business Name | Name of the connected WhatsApp Business account | | Phone Number | Configured business WhatsApp number | | Phone Number ID | WhatsApp Business phone number identifier | | WABA ID | WhatsApp Business Account identifier | | WhatsApp Client ID | Antryk WhatsApp client identifier | | Sync Status | Current WhatsApp synchronization state | The synchronization status indicates whether the WhatsApp service has completed its configuration or is still pending synchronization. ### WhatsApp Service Actions The overview page provides service management actions. * #### Disconnect WhatsApp The **Disconnect** button allows administrators to disconnect the configured WhatsApp service from Antryk. Use this action when the business WhatsApp number should no longer be managed through the current service. * #### Configure Webhook The **Webhook** button opens the webhook configuration drawer. The webhook configuration allows Antryk to forward WhatsApp events to your application in real time. *** ## WhatsApp Webhook Configuration WhatsApp webhook configuration drawer showing callback URL, signing secret, sample payload, and test event controls The WhatsApp webhook configuration panel allows you to configure how Antryk delivers WhatsApp events to your application. ### Callback URL Enter the endpoint where Antryk should send webhook events. Your callback URL receives WhatsApp activity through HTTP POST requests. ### Signing Secret The **Signing Secret** is used to verify the authenticity of webhook requests sent to your callback URL. Your application should validate the webhook signature before processing the incoming event. ### Sample Payload The webhook configuration panel provides a sample payload that can be used to understand the structure of webhook events. ### Send Test Event The **Send Test Event** button allows you to test connectivity between Antryk and your callback URL using the sample payload. This is useful for verifying that: * Your callback URL is reachable * Your server accepts POST requests * Your webhook handler is working correctly * Your request authentication logic is configured correctly ### Webhook Configuration Actions * **Cancel** — Close the webhook configuration drawer without saving changes. * **Save Configuration** — Save the callback URL and signing secret. *** # WhatsApp Webhook Events When your account receives WhatsApp activity, Antryk forwards a clean, normalized payload to your configured *callback URL* using a POST request. All requests are signed using your configured `callbackSecret`. Verify the signature before trusting and processing the payload. *** ## Event Types Overview | Event | Triggered When | | ----------------- | -------------------------------------------------------------------------- | | `message` | A customer sends you a message such as text, image, video, or document | | `message_echo` | Your team sends a message directly from the WhatsApp Business app | | `message_edited` | Your team edits a message previously sent from the WhatsApp Business app | | `message_revoked` | Your team deletes a message previously sent from the WhatsApp Business app | | `message_status` | A message changes delivery state such as sent, delivered, read, or failed | *** ## Common Webhook Fields Reference | Field | Type | Description | | --------------- | --------------- | ------------------------------------------------------------------------------------------------------ | | `event` | string | Event type such as `message`, `message_echo`, `message_edited`, `message_revoked`, or `message_status` | | `status` | string | Delivery state for `message_status`: `sent`, `delivered`, `read`, or `failed` | | `from` | string | Sender phone number in E.164 format without `+` | | `to` | string | Recipient phone number | | `messageId` | string (UUID) | Antryk internal message record ID | | `waMessageId` | string | WhatsApp message ID used to correlate messages | | `messageType` | string | Message type such as `text`, `image`, `audio`, `video`, `document`, or `template` | | `body` | string \| null | Message text or media caption | | `mediaUrl` | string \| null | Permanent media URL once the media has been downloaded and resolved | | `timestamp` | ISO 8601 string | Time when the event or message was recorded | | `phoneNumberId` | string | WhatsApp Business phone number ID | | `wabaId` | string | WhatsApp Business Account ID | | `contact` | object \| null | Customer WhatsApp profile information for incoming message events | *** ## Webhook Retry & Delivery Behavior Antryk automatically retries webhook delivery when your callback endpoint fails. For reliable webhook processing: * Return a `2xx` response quickly. * Keep webhook processing asynchronous where possible. * Avoid long-running operations inside the webhook request. * Make your webhook handler idempotent. * Use `waMessageId` to identify and deduplicate WhatsApp messages. * Monitor failed webhook requests from the Webhook Audit Logs. If your endpoint remains unreachable after all retry attempts, the event is recorded in Antryk logs but is not queued indefinitely. Slow responses can be treated as failed deliveries and may result in retry attempts and duplicate webhook requests. *** ## Webhook Audit Logs Whatsapp Service Webhook Audit Logs Page Webhook Audit Logs provide a real-time delivery tracking and debugging console for webhook requests sent by Antryk. The audit log helps developers identify failed webhook deliveries, inspect request payloads, and troubleshoot callback endpoint issues. ### Webhook Log Information | Column | Description | | ----------- | ----------------------------------------------- | | Date & Time | Time when the webhook delivery attempt occurred | | Event ID | Unique identifier for the webhook event | | Status | HTTP response status such as `200` or `401` | | Attempts | Number of delivery attempts | | Result | Whether delivery was successful or failed | ### Webhook Log Details Clicking any webhook audit log opens a detail drawer containing additional information about the delivery attempt. Webhook Detail Drawer ### Log Details Include * Event information * Delivery status * Attempt information * Target URL * Request payload * Response information * Debugging details This makes the webhook audit log useful for diagnosing authentication failures, unreachable endpoints, invalid responses, and other integration issues. *** ## WhatsApp Message Logs Whatsapp Service Message Logs Message Logs, also called Message Audit Logs, provide real-time visibility into WhatsApp messages exchanged through your connected business number. The message logs help teams monitor conversations, delivery status, incoming messages, outgoing messages, and message activity. ### Message Log Information | Column | Description | | --------------- | ------------------------------- | | Date & Time | Time the message event occurred | | Customer Number | Customer WhatsApp phone number | | Direction | Incoming or outgoing message | | Body | Message content or preview | | Status | Current message state | ### Message Direction The Direction column uses arrows to distinguish between incoming and outgoing WhatsApp messages. * **Incoming** — Message received from a customer. * **Outgoing** — Message sent by your business. ### Message Status Depending on the message lifecycle, statuses can include: * Received * Sent * Delivered * Read * Failed *** ## WhatsApp Inbox Whatsapp Service Inbox Page where user can send and recieve message The Antryk WhatsApp Inbox provides a familiar WhatsApp-style interface for managing customer conversations from the dashboard. Teams can view contacts, open conversations, read previous messages, and respond to customers without leaving the Antryk platform. ### Conversation List The conversation list displays customers who have interacted with your connected WhatsApp Business number. Each conversation can be selected to open the complete chat history. ### Send WhatsApp Messages From Inbox The inbox allows customer support and business teams to respond directly to customers. Teams can: * Send text messages * Send files * Share media * Continue existing conversations * View incoming customer messages * Monitor outgoing message status The inbox provides a centralized workspace for two-way WhatsApp customer communication. *** ## WhatsApp Messaging APIs & SDK Antryk provides developer-friendly APIs for integrating WhatsApp messaging into your applications. Instead of manually sending messages from the dashboard, developers can integrate WhatsApp communication directly into their applications, backend services, customer support systems, and automated workflows. Learn how to send WhatsApp messages programmatically. Receive WhatsApp messages and delivery events through webhooks. *** ## Best Practices ### WhatsApp Messaging * Obtain appropriate customer opt-in before sending messages. * Use clear and useful message content. * Keep notification messages concise and relevant. * Monitor delivery and read rates. * Avoid unnecessary or duplicate messages. * Use media only when it adds value to the conversation. ### Webhook Integration * Always verify the webhook signature when a signing secret is configured. * Return a `2xx` response quickly. * Process events asynchronously where appropriate. * Make webhook handlers idempotent. * Use `waMessageId` to prevent duplicate message processing. * Monitor failed webhook attempts from the dashboard. * Test your callback URL using the Send Test Event feature before going live. ### Inbox & Support * Keep customer conversations organized. * Respond promptly to incoming messages. * Use the message logs for troubleshooting. * Monitor failed and undelivered messages. * Use consistent business communication practices across support teams. *** ## WhatsApp Service Workflow A typical Antryk WhatsApp integration follows this workflow: 1. Connect your WhatsApp Business number. 2. Configure the WhatsApp service from the dashboard. 3. Confirm the synchronization status. 4. Configure a webhook callback URL. 5. Add a signing secret for webhook verification. 6. Send a test webhook event. 7. Start sending and receiving WhatsApp messages. 8. Monitor message activity through Message Logs. 9. Monitor webhook delivery through Webhook Audit Logs. 10. Manage customer conversations through the WhatsApp Inbox. 11. Integrate the WhatsApp APIs into your application for automated messaging. *** ## Frequently Asked Questions ### What is Antryk WhatsApp Services? Antryk WhatsApp Services provides programmable WhatsApp Business messaging infrastructure for notifications, customer support, automated communication, media messaging, and two-way customer conversations. ### Can I connect my existing WhatsApp Business number? Yes. You can configure your business WhatsApp number through the Connect WhatsApp workflow in the Antryk dashboard. ### Can I send WhatsApp messages using an API? Yes. Antryk provides APIs for sending WhatsApp messages programmatically from your applications. ### Can I receive WhatsApp messages? Yes. Incoming WhatsApp activity can be received through configured webhooks and can also be managed through the Antryk WhatsApp Inbox. ### Can I monitor message delivery? Yes. Message Logs provide visibility into message activity and delivery states such as sent, delivered, read, received, and failed. ### Can I monitor webhook failures? Yes. Webhook Audit Logs provide delivery attempts, HTTP response status codes, event IDs, target URLs, payloads, and debugging information. ### Can my team reply to customers from Antryk Dashboard? Yes. The WhatsApp Inbox provides a WhatsApp-style interface where your team can view conversations and send messages and files to customers. ### How do I verify WhatsApp webhook requests? Configure a signing secret in the webhook settings and verify the signature of incoming webhook requests before processing their payloads. *** ## Next Steps Learn how to send WhatsApp messages programmatically. Receive WhatsApp messages and delivery events through webhooks.