Feature available for :LinkedIn, WhatsApp, Instagram, Messenger, Telegram, X (Twitter), Google, Microsoft, IMAP
Unipile's Account Status Webhook is a powerful feature that allows you to monitor the life cycle of an account's status and take actions based on changes in the status. This Webhook provides real-time updates on the synchronization status of your accounts, and on the connection creation.
Synchronization status
Here is an example payload for a synchronization request:
Here is the different Synchronization status that can be notified by the Webhook.
Status
Description
OK
Everything seems to be in good order.
When the account status is notOK:
You can still retrieve any data (chats, messages...) using GET Methods, but this data is no more guaranteed to be up to date with the messaging provider.
You will not receive anymore updates on new messages through Webhooks.
ERROR /STOPPED
Account synchronization has stopped due to an unexpected error during data fetching.
CREDENTIALS
Synchronization of accounts has been interrupted due to invalid or missing credentials required for retrieving new data. This situation may arise in several scenarios, including, but not limited to:
IMAP::
User updates their provider's password.
Email (Google/Microsoft) :
User revokes your application's authorization from their account center
Admin of user revoke permissions of App or current tokens for security reason
User change his credentials and check option to revoke current token
Account not exist anymore or email configured changed
OAuth keys changed in your settings
Not enough scopes checked by enduser
WhatsApp/Telegram:
Users terminating the session via the app settings
Excessive requests to sensitive endpoints (such as fetching profiles or sending message without good answer rate or high report by user) can cause temporary of definitive restriction
Phone have no network for long period
Instagram
Instagram ask for security checkpoint you need to validate on UI and reconnect
The session expiration after one year
Users terminating the session via the preference settings
User change his credentials and check option to revoke current token
Excessive requests to sensitive endpoints (such as fetching profiles or sending invitations, check this page to view recommendations).
Your proxy is too slow or down for extended period
LinkedIn:
The session expiration after one year
Users terminating the session via the preference settings
User change his credentials and check option to revoke current token or activate 2FA
Excessive requests to sensitive endpoints (such as fetching profiles or sending invitations, check this page to view recommendations).
Too many request with with reject code (invalid_attendee, insufficient_credit..) (you need to handle error code and stop/adapt sequence)
Users may be prompted to select a session (Only with Recruiter account connected with "Credentials, use "Cookies" method to bypass)
When connected with "Cookies" : User logs out in their browser (for example to switch account).
When connected with "Cookies" and mainly "Custom Auth": Providing an incorrect user agent
Your proxy is too slow or down for extended period
CONNECTING
The account is attempting to connect. If your credentials are correct, it may be because the provider is temporarily down, your proxy or a synchronization catch-up. It's temporary status.
DELETED
You deleted the account
CREATION_SUCCESS
The account was successfully added and the initial data synchronization has begun. CREATION_SUCCESS can be notified by the Webhook and/or "notify_url" in hosted auth (not with same format).
RECONNECTED
Account has been reconnected with success. Can be notified by the Webhook and/or "notify_url" in hosted auth (not with same format).
SYNC_SUCCESS
Only for LinkedIn/IMAP/WhatsApp/Instagram | The account (re)synchronization is finished