Webhooks and message status
Provider callbacks bring incoming messages and available delivery or read updates into your INSIDE conversations.
What it is
Messaging services notify INSIDE when customers send messages and when supported delivery events occur. These notifications are called webhooks. They let INSIDE update conversations without an operator checking the provider's own inbox.
Who uses it and why
- Developers coordinate callback configuration with Powerfront when connecting a service.
- Operators use message status and error information to understand whether a reply was sent or read.
Where to find it
Powerfront manages callback details in Settings › General Settings › Integrations. Depending on the provider, the account screen shows Webhook Url, Callback Webhook Url or Generate Verification Token.
Operators see supported message status updates in the conversation transcript.
How it works
- The provider sends an event for a connected business account.
- INSIDE identifies the account and customer, then processes supported content or status information.
- Incoming content becomes a conversation message. Delivery callbacks update the matching outgoing message when INSIDE can identify it.
Some services require a setup challenge before they begin sending events. Passing that challenge confirms the setup exchange; it does not prove that an incoming message or operator reply will succeed.
Verification differs by provider. LINE uses account credentials to validate events, native Viber checks an account-specific signature, Apple Messages checks authorisation and Twitter checks signed notifications. There is no single verification option that applies to every channel.
Configure it
Ask Powerfront to supply the callback details for your account and complete any provider verification or subscription steps. For Twilio WhatsApp, incoming messages and status callbacks have separate displayed callback details.
Test incoming messages, outgoing replies and available receipts separately. A working incoming message does not confirm that status notifications are configured.
Limits and good to know
- Receipt availability depends on the service and the events it sends. Absence of a read receipt does not establish that a customer has not read the message.
- WhatsApp Meta maps both provider sent and delivered updates to Sent in INSIDE. Do not interpret this indicator alone as a distinct device-delivery confirmation.
- A callback acknowledgement is not a customer delivery receipt.
- Unsupported event types do not necessarily produce transcript entries.
- Duplicate handling varies by service. Do not rely on a common replay or recovery function across all providers.
Depends on and works with
+1 more · this feature uses
- SMS number and channel setupConfigured by
SMS number records identify the business account for incoming texts and status updates.
+9 more · used by
- LINE messaging channel setupRequires
Signed provider notifications import customer messages and choices.
- WeChat messaging channel setupRequires
Verified account notifications bring messages and authorisation changes into INSIDE.
- KakaoTalk messaging conversationsRequires
Notifications report messages, agent requests and session expiry.
- Viber messaging channel setupRequires
Provider notifications import messages and delivery or read updates.
- Vonage connection for ViberRequires
Incoming notifications carry customer messages and delivery status.
- Apple Messages conversationsRequires
Account notifications import messages, customer actions and conversation closure.
- Legacy Google Business Messages connectionRequires
Provider notifications supply messages, selections and receipts.
- Legacy Twitter direct messagesRequires
Signed account-activity notifications bring messages and read updates into INSIDE.
- SMS number and channel setupRequires
Provider notifications supply incoming texts, media and delivery updates.
View all connections as a list
This feature uses
- Message delivery and read receiptsEnhances
Supported callbacks update message delivery and read indicators.
- Messaging channel connectionsConfigured by
Connected messaging account records determine which business account incoming callbacks belong to.
- WhatsApp channel setupConfigured by
WhatsApp account setup supplies the incoming-message and status callback configuration.
- Facebook Messenger channel setupConfigured by
Messenger Page authorisation and subscriptions determine which callbacks reach INSIDE.
- LINE messaging channel setupConfigured by
LINE account credentials determine whether incoming callbacks pass verification.
- Viber messaging channel setupConfigured by
The selected Viber provider and account credentials determine callback routing and verification.
- Apple Messages conversationsConfigured by
Apple Messages account credentials authorise incoming callbacks.
- Legacy Twitter direct messagesConfigured by
Twitter account credentials and subscriptions control signed incoming notifications.
- SMS number and channel setupConfigured by
SMS number records identify the business account for incoming texts and status updates.
Used by
- Message delivery and read receiptsEnhances
Connected messaging providers can supply delivery and read acknowledgements.
- Messaging channel connectionsRequires
Receiving messages through a connected service requires its incoming callbacks.
- Messaging conversationsRequires
Provider callbacks supply incoming messages and status updates.
- WhatsApp channel setupRequires
Callbacks supply incoming messages and available delivery updates.
- WhatsApp message templatesEnhances
Message callbacks report delivery independently of template approval.
- WhatsApp Business App connectionRequires
Meta supplies mobile message, history, contact and account-change callbacks.
- Facebook Messenger channel setupRequires
Messenger callbacks provide messages, button replies and read events.
- Instagram messages and story repliesRequires
Provider notifications bring messages, reactions and read updates into INSIDE.
- LINE messaging channel setupRequires
Signed provider notifications import customer messages and choices.
- WeChat messaging channel setupRequires
Verified account notifications bring messages and authorisation changes into INSIDE.
- KakaoTalk messaging conversationsRequires
Notifications report messages, agent requests and session expiry.
- Viber messaging channel setupRequires
Provider notifications import messages and delivery or read updates.
- Vonage connection for ViberRequires
Incoming notifications carry customer messages and delivery status.
- Apple Messages conversationsRequires
Account notifications import messages, customer actions and conversation closure.
- Legacy Google Business Messages connectionRequires
Provider notifications supply messages, selections and receipts.
- Legacy Twitter direct messagesRequires
Signed account-activity notifications bring messages and read updates into INSIDE.
- SMS number and channel setupRequires
Provider notifications supply incoming texts, media and delivery updates.
FAQ and troubleshooting
Incoming messages work. Why do outgoing messages have no read status?
The provider may not have supplied a read event, or its status callback configuration may be incomplete. Ask Powerfront to check a specific message and time.
Does successful webhook verification mean the account is ready?
It confirms one setup step. Complete an incoming and outgoing message test as well.
Why does an outgoing message show an error later?
The provider can report failure after INSIDE submits the message. Review the message error and give Powerfront the account and message time if it needs investigation.
Can I replay a callback from INSIDE?
There is no common client replay control for these integrations. Ask Powerfront to investigate missing or repeated events.