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

# Receive template delivery report

> Webhook your application must implement. Beem POSTs WhatsApp template delivery status updates (accepted, delivered, read, failed) to the callback URL configured in the Engage portal under API Setup. Replace the server URL with your own HTTPS endpoint.



## OpenAPI

````yaml /openapi/moja.json post /template-dlr
openapi: 3.0.3
info:
  title: Beem MOJA API
  version: 1.0.0
  description: >-
    Merged MOJA API reference covering the Chat API (chatbot-core), WhatsApp
    template broadcast API (bm-broadcast), and the customer-hosted message
    callback webhook.
  contact:
    name: Beem
    url: https://beem.africa
    email: support@beem.africa
servers:
  - url: https://apichatcore.beem.africa
    description: Default — Chat API (chatcore)
security: []
tags: []
paths:
  /template-dlr:
    post:
      summary: Receive template delivery report
      description: >-
        Webhook your application must implement. Beem POSTs WhatsApp template
        delivery status updates (accepted, delivered, read, failed) to the
        callback URL configured in the Engage portal under API Setup. Replace
        the server URL with your own HTTPS endpoint.
      operationId: receiveTemplateDeliveryReport
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                broadcast_id:
                  type: string
                  description: Broadcast job ID from the template send request.
                message_id:
                  type: string
                  description: Unique message ID for this delivery report.
                status:
                  type: string
                  enum:
                    - accepted
                    - delivered
                    - read
                    - failed
                  description: Delivery status of the template message.
                destination:
                  type: string
                  description: Recipient phone number.
                message:
                  type: string
                  description: Message content or status detail.
                timestamp:
                  type: string
                  description: When the status update occurred.
            examples:
              delivered:
                summary: Message read
                value:
                  broadcast_id: broadcastid_123123
                  message_id: msgid_123123
                  status: read
                  destination: 255******581
                  message: Your order has shipped
                  timestamp: '2023-06-26 02:31:29'
      responses:
        '200':
          description: Acknowledge receipt of the delivery report
      servers:
        - url: https://example.com
          description: Your callback server — replace with your URL

````