Onpipeline lets you manage WhatsApp conversations directly from your CRM. You can send and receive messages, share attachments, view conversation history, and monitor message delivery status.
This guide explains how to use the WhatsApp inbox, send messages and attachments, understand delivery status indicators, and manage the 24-hour customer service window.
Accessing the WhatsApp inbox
Open the WhatsApp section in Onpipeline to view the conversations available to you.
If multiple WhatsApp numbers are connected, use the channel selector to choose the number you want to work with.
The conversations you can access depend on your individual or team channel permissions.
Available actions
From the WhatsApp inbox, you can:
- Search conversations by customer name or phone number.
- Open conversations and view message history.
- Send text messages and emojis.
- Send images, documents, audio, and supported video files.
- Preview images and supported media.
- Open or download attachments.
- View message delivery status.
- Access linked CRM contacts and deals.
For supported WhatsApp Business App Coexistence configurations, messages sent through the Business App may also appear in Onpipeline.
Selecting the correct WhatsApp number
If your account has access to multiple WhatsApp channels, always verify which number is selected before sending a message.
Each business number maintains separate conversations with customers, even when those conversations are associated with the same CRM contact.
Sending messages and attachments
When the customer’s 24-hour service window is open, you can send regular WhatsApp messages directly from Onpipeline.
Sending a text message
- Open the WhatsApp inbox.
- Select the appropriate WhatsApp number.
- Open the customer’s conversation.
- Enter your message.
- Send the message.
The message appears in the conversation history.
Sending an attachment
Onpipeline supports several types of attachments, including:
- Images
- PDF documents
- Word documents
- Excel files
- Audio files
- Supported video files
To send an attachment:
- Open the customer’s WhatsApp conversation.
- Use the attachment option.
- Select the file you want to send.
- Send the attachment.
Supported media can be previewed directly in Onpipeline, while document attachments can be opened or downloaded.
Important: Regular messages and attachments can only be sent when permitted by WhatsApp’s customer service window rules.
Understanding message delivery status
Onpipeline displays message status indicators based on delivery and read notifications received from Meta through the WhatsApp Business Platform.
The following indicators may appear:
| Indicator | Meaning |
|---|---|
| Clock | Pending |
| Single check | Sent |
| Double check | Delivered |
| Blue double check | Read |
| Red exclamation mark | Failed |
How message status updates work
When a message is sent through Onpipeline, Meta processes it and may subsequently send notifications indicating whether it was sent, delivered, read, or failed.
Onpipeline updates the displayed message status based on the notifications it receives from Meta.
Message status updates depend on Meta’s notifications, which may be delayed or may not arrive for various reasons.
Read confirmations may also depend on the recipient’s privacy settings and WhatsApp’s supported behavior.
Failed messages
If Meta reports a delivery failure, Onpipeline displays a red exclamation mark.
When available, the error information provided by Meta appears beneath the failed message, including:
- Error title
- Error code
- Error details
However, if Meta does not send the corresponding failure notification, Onpipeline may not be able to identify or display the actual delivery failure.
Important considerations
Message status indicators reflect the latest information available to Onpipeline, not necessarily the actual current status of the message on WhatsApp. Onpipeline cannot guarantee that all read notifications will be received, or that the displayed status will always reflect the final outcome of a message.
Understanding the 24-hour customer service window
The WhatsApp Business Platform uses a 24-hour customer service window to determine when businesses can send regular messages to customers.
When does the window open?
The window opens when a customer sends a WhatsApp message to your business.
During the following 24 hours, your business can send supported regular messages, including text and attachments.
Every new incoming customer message resets the window.
Example
A customer sends a message on Monday at 10:00 AM.
- Monday, 10:00 AM: The customer sends a message and opens the 24-hour window.
- Until Tuesday, 10:00 AM: Your business can send regular replies.
- After Tuesday, 10:00 AM: Regular free-form messages are no longer permitted unless the customer sends another message.
What happens when the window closes?
When the 24-hour customer service window expires, regular free-form messages cannot be sent through the WhatsApp Cloud API.
To initiate or resume communication, your business must send an appropriate approved WhatsApp message template.
Alternatively, if the customer sends a new message, another 24-hour service window opens.
Important: The 24-hour customer service window is not the same as an Onpipeline conversation record.
A conversation can remain visible in your CRM even when the messaging window is closed.
Troubleshooting
Regular messages cannot be sent
Possible cause: The 24-hour customer service window has expired.
Solution: Use an approved WhatsApp message template to resume communication, or wait until the customer sends another message.
A message remains in Pending or Sent status
Message status updates depend on notifications received from Meta.
These notifications may be delayed or may not arrive.
Therefore, a message remaining in Pending or Sent status does not necessarily mean that delivery failed.
A message shows a red exclamation mark
Meta has reported a delivery failure.
Check the error information displayed beneath the message.
The problem may concern:
- Billing configuration
- Account eligibility
- Recipient restrictions
- Meta messaging policies
- Other delivery errors
Use the error code and details provided by Meta to investigate the cause.
A conversation is missing
If you cannot find a conversation:
- Verify that the correct WhatsApp number is selected.
- Check your individual or team channel permissions.
- Remember that the same customer may have separate conversations with different business numbers.
Recommended practices
To manage WhatsApp messages effectively:
- Always verify the selected WhatsApp number before sending.
- Keep customer conversations linked to the appropriate CRM contacts and deals.
- Remember that delivery and read status updates depend on Meta’s notifications.
- Do not assume that a message failed simply because its status has not changed.
- Use approved templates when communicating outside the 24-hour customer service window.
- Check error details when Meta reports a delivery failure.
- Use supported file formats for attachments.
- Do not treat message status indicators as guaranteed real-time confirmations.
