Search documentation

Search for a topic, a control, or an event type.

    Docs / Workflows / Integrations / WhatsApp Business

    WhatsApp Business

    Send WhatsApp Business messages and react to incoming messages and delivery status.

    What you can do

    Each WhatsApp Business integration’s page in OAIZ shows these uses, with its events and its read and write actions, under What you can do with WhatsApp Business.

    Order status replies
    Reply to customer messages with their order status.
    Shipping messages
    Send an approved template message when an order ships.
    Photos and documents
    Send the photo or document a customer asks for.

    Connection scope

    A connection uses a WhatsApp Business phone number. Free-form replies require an open customer service window, the 24 hours after the recipient’s last inbound message. Outside that window, sending requires an approved template.

    Connecting

    Authorize OAIZ through Meta using an account that can access your WhatsApp Business Account and its registered phone number. The connection uses the first accessible WhatsApp Business Account with a phone number returned by Meta.

    The authorization requests whatsapp_business_management, whatsapp_business_messaging and business_management. OAIZ subscribes the connected business account to incoming-message webhooks. Check the connected phone number before using it to send messages.

    Read actions

    List Templates
    List this account's WhatsApp Business message templates with their name, language and approval status.
    Get Template
    Read an approved template’s language and component structure, including its parameter order.
    Get Media URL
    Get a short-lived download URL for a media file held by WhatsApp.
    Get Business Profile
    Read the business profile’s description and contact details.
    Get Phone Info
    Read the connected phone number’s details.

    Write actions

    Send Message
    Send a text message during the open 24-hour customer service window.
    Send Template Message
    Send an approved template with its language and declared parameters, including outside the customer service window.
    Send Media Message
    Send an image, video, audio or document from a media URL or ID during the customer service window.
    Send Interactive Message
    Send reply buttons or list options during the customer service window.
    Send Location Message
    Send a location during the customer service window.
    Reply to Message
    Send a reply quoting a message during the customer service window.
    Mark as Read
    Mark an inbound message as read, showing a read receipt.

    Events

    Message Received events carry inbound content. Message Sent, Message Delivered, Message Read and Message Failed events track outbound status. A successful send result provides a message ID, while delivery is reported separately.