Channels

Read channel connection progress

Use attemptId returned by create_channel_connection_link. Read saved progress on user request; do not run unbounded polling. Pending/authorizing/selecting requires human browser completion. Processing is uncertain and must not trigger another callback. Completed/partial returns actual saved channelIds; inspect each with get_channel to verify readiness. Failed or expired does not prove no channel was saved: reconcile returned IDs and list_channels before a new attempt. Records expire after 24 hours; a later 404 is a retention gap, not evidence of no connection. Requires channels:read.

get/channels/connection-attempts/{attemptId}

Request

  • Base URL
    https://platform-api.visitoai.com/m2m/v1
  • Auth
    HTTP bearer

Path parameters

attemptIdstring required

attemptId returned by create_channel_connection_link, not a channel ID or OAuth state.

Response

Read channel connection progress

attemptIdstring required
tenantIdstring required
type'instagram' | 'messenger' | 'whatsapp' required
provider'meta' required
status'pending' | 'authorizing' | 'processing' | 'selecting' | 'completed' | 'partial' | 'failed' | 'expired' required
expiresAtstring date-time required
channelIdsstring[] required
failureCodestring
nextActionstring required
connectionUrlstring uri

Temporary browser link. Share with the intended business admin; do not log, index or expose to third parties.

Changes

No recorded changes to this operation across all 1 revision of this API.