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.