Connect a WhatsApp number
Understand Embedded Signup, coexistence and connection states.
Customer-owned assets
An organization connects its own Meta business assets through Sqkii's provider application. Users do not create their own Meta developer app. They still complete consent, business selection, number verification where required, and Meta eligibility steps.
Sqkii uses Embedded Signup v5. Its completion payload separates messaging-account IDs, business-portfolio ID and phone-number ID. The server exchanges the authorization code and verifies the selected assets; identifiers from a browser event alone are not trusted.
Existing Business app number
Coexistence keeps an eligible WhatsApp Business app number usable in the app and through the API. Existing consumer WhatsApp accounts are not a personal-inbox API. Existing group conversations are not synchronized through the coexistence history flow.
Contact and history synchronization require customer consent and timely initiation after onboarding. History delivery is asynchronous and can be incomplete. The interface displays synchronization progress and actionable failure states. Imported content is trimmed to the configured retention period, at most 90 days by default.
Do not call the normal number-registration endpoint for a coexistence number that is already registered. Do not promise that every companion-client action will synchronize.
Fresh number
The new-number flow completes the Cloud API registration steps appropriate to that number. A number becomes operational only after the required account, permission and registration checks pass.
Connection states
Read the actual connection state: pending consent, pending verification, synchronizing, permission required, ready, failed or disconnected. A ready simulator is distinct from a ready live connection.
Reconnection and offboarding
Revoked permissions or token expiry stop live operations with a diagnostic error. Reconnect through the UI rather than pasting a permanent token into client code. Coexistence offboarding may require action in the WhatsApp Business app; disconnecting an integration is not equivalent to deleting the business's Meta assets.