> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zuwinda.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Messages

> Messages webhook zuwinda.com

## Whatsapp Account

Below is the list of event types that Zuwinda uses when sending HTTP messages. This standardized format is designed to simplify your integration process and ensure consistent data delivery.

<ResponseField name="messaging.whatsapp.message.incoming" type="data.object">
  Message received from your whatsapp account.

  <CodeGroup>
    ```json Text theme={null}
    {
      "event": "messaging.whatsapp.message.incoming",
      "accountId": "a9a8a2be-6668-4f40-891f-a3735ad62b7d",
      "whatsapp_number": "628151xxxxxx",
      "chatId": "FB017DD4DACC069EB1",
      "from": "62851808xxxxx",
      "fromMe": false,
      "isGroup": false,
      "display_name": "62851808xxxxx",
      "messageType": "text",
      "text": { 
        "body": "hi" 
      },
      "timestamp": "2025-09-24T15:15:07Z"
    }
    ```

    ```json Quoted theme={null}
    {
      "event": "messaging.whatsapp.message.incoming",
      "accountId": "a9a8a2be-6668-4f40-891f-a3735ad62b7d",
      "whatsapp_number": "628151xxxxxx",
      "chatId": "FB017DD4DACC069EB1",
      "from": "62851808xxxxx",
      "fromMe": false,
      "isGroup": false,
      "display_name": "62851808xxxxx",
      "messageType": "text",
      "text": { 
        "body": "hi", 
        "replied_id": "AC283A55866E9CAF933284354B493D92", 
        "quoted_message": "hi world?" 
      },
      "timestamp": "2025-09-24T15:15:07Z"
    }
    ```

    ```json Image theme={null}
    {
      "event": "messaging.whatsapp.message.incoming",
      "accountId": "a9a8a2be-6668-4f40-891f-a3735ad62b7d",
      "whatsapp_number": "628151xxxxxx",
      "chatId": "FB017DD4DACC069EB1",
      "from": "62851808xxxxx",
      "fromMe": false,
      "isGroup": false,
      "display_name": "62851808xxxxx",
      "messageType": "image",
      "image": { 
        "url": "https://example.com",
        "caption": "",
        "mimetype": "image/jpeg"
      },
      "timestamp": "2025-09-24T15:15:07Z"
    }
    ```

    ```json Document theme={null}
    {
      "event": "messaging.whatsapp.message.incoming",
      "accountId": "a9a8a2be-6668-4f40-891f-a3735ad62b7d",
      "whatsapp_number": "628151xxxxxx",
      "chatId": "FB017DD4DACC069EB1",
      "from": "62851808xxxxx",
      "fromMe": false,
      "isGroup": false,
      "display_name": "62851808xxxxx",
      "messageType": "document",
      "document": { 
        "url": "https://example.com",
        "caption": "",
        "mimetype": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"
      },
      "timestamp": "2025-09-24T15:15:07Z"
    }
    ```

    ```json Audio theme={null}
    {
      "event": "messaging.whatsapp.message.incoming",
      "accountId": "a9a8a2be-6668-4f40-891f-a3735ad62b7d",
      "whatsapp_number": "628151xxxxxx",
      "chatId": "FB017DD4DACC069EB1",
      "from": "62851808xxxxx",
      "fromMe": false,
      "isGroup": false,
      "display_name": "62851808xxxxx",
      "messageType": "audio",
      "audio": { 
        "url": "https://example.com",
        "caption": "",
        "mimetype": "audio/mpeg"
      },
      "timestamp": "2025-09-24T15:15:07Z"
    }
    ```

    ```json Video theme={null}
    {
      "event": "messaging.whatsapp.message.incoming",
      "accountId": "a9a8a2be-6668-4f40-891f-a3735ad62b7d",
      "whatsapp_number": "628151xxxxxx",
      "chatId": "FB017DD4DACC069EB1",
      "from": "62851808xxxxx",
      "fromMe": false,
      "isGroup": false,
      "display_name": "62851808xxxxx",
      "messageType": "video",
      "video": { 
        "url": "https://example.com",
        "caption": "",
        "mimetype": "video/mp4"
      },
      "timestamp": "2025-09-24T15:15:07Z"
    }
    ```

    ```json Sticker theme={null}
    {
      "event": "messaging.whatsapp.message.incoming",
      "accountId": "a9a8a2be-6668-4f40-891f-a3735ad62b7d",
      "whatsapp_number": "628151xxxxxx",
      "chatId": "FB017DD4DACC069EB1",
      "from": "62851808xxxxx",
      "fromMe": false,
      "isGroup": false,
      "display_name": "62851808xxxxx",
      "messageType": "sticker",
      "sticker": { 
        "url": "https://example.com",
        "caption": "",
        "mimetype": "image/webp"
      },
      "timestamp": "2025-09-24T15:15:07Z"
    }
    ```

    ```json Location theme={null}
    {
      "event": "messaging.whatsapp.message.incoming",
      "accountId": "a9a8a2be-6668-4f40-891f-a3735ad62b7d",
      "whatsapp_number": "628151xxxxxx",
      "chatId": "FB017DD4DACC069EB1",
      "from": "62851808xxxxx",
      "fromMe": false,
      "isGroup": false,
      "display_name": "62851808xxxxx",
      "messageType": "location",
      "location": { 
        "latitude": -8.0948253,
        "longitude": 112.1652559,
        "thumbnail": "base64 string"
      },
      "timestamp": "2025-09-24T15:15:07Z"
    }
    ```

    ```json Live Location theme={null}
    {
      "event": "messaging.whatsapp.message.incoming",
      "accountId": "a9a8a2be-6668-4f40-891f-a3735ad62b7d",
      "whatsapp_number": "628151xxxxxx",
      "chatId": "FB017DD4DACC069EB1",
      "from": "62851808xxxxx",
      "fromMe": false,
      "isGroup": false,
      "display_name": "62851808xxxxx",
      "messageType": "livelocation",
      "livelocation": { 
        "latitude": -8.0948253,
        "longitude": 112.1652559,
        "sequenceNumber": 12312314344,
        "thumbnail": "base64 string"
      },
      "timestamp": "2025-09-24T15:15:07Z"
    }
    ```
  </CodeGroup>
</ResponseField>

<ResponseField name="messaging.whatsapp.message.status" type="data.object">
  Update message status, sent, delivered, read, or played.

  <CodeGroup>
    ```json Data theme={null}
    {
      "event": "messaging.whatsapp.message.status",
      "accountId": "a9a8a2be-6668-4f40-891f-a3735ad62b7d",
      "whatsapp_number": "628151xxxxxx",
      "messageId": "FB017DD4DACC069EB1",
      "status": "read",
      "timestamp": "2025-09-24T15:15:07Z"
    }
    ```
  </CodeGroup>
</ResponseField>

<ResponseField name="messaging.whatsapp.status" type="data.object">
  Update status of your whatsapp account

  <CodeGroup>
    ```json Data theme={null}
    {
      "event": "messaging.whatsapp.status",
      "accountId": "a9a8a2be-6668-4f40-891f-a3735ad62b7d",
      "whatsapp_number": "628151xxxxxx",
      "status": "connected",
      "timestamp": "2025-09-24T15:15:07Z"
    }
    ```
  </CodeGroup>
</ResponseField>