Skip to main content
A Channel connects an AI Agent to the messaging platform where the customer is. Before the Agent can process any message, you need to create at least one Channel and authenticate it. The creation flow is similar for all types, with variations in the credentials step.

General configuration parameters

FieldDescription
Internal nameIdentifier for the Channel in Inbox filters and reports. Examples: “WhatsApp Support US”, “Main Site Widget”
Channel typeWhatsApp WABA, Instagram, Web Widget, Telegram, or Slack
Linked AgentThe AI Agent that will process messages received on this Channel
StatusActive (processing messages) or Paused (Channel connected but Agent suspended)
CredentialsToken, App Secret, or OAuth data depending on the chosen channel type

Channel management

ActionDescription
PauseKeeps saved credentials but suspends processing of new messages — useful for maintenance without needing to reconnect
ReconnectRestarts the authentication flow when credentials expire or are revoked on the source platform
Edit nameChanges the internal name without interrupting the connection or affecting Conversation history
DeleteRemoves the Channel and permanently stops processing; existing Conversations remain in the history
Test connectionSends a verification request to the platform API and displays the response status

Troubleshooting

ProblemLikely causeSolution
Channel stays in “Awaiting verification”Invalid token or insufficient permissions on the source platformReview credentials and confirm that the required permissions were granted before saving
Messages arrive but Agent does not respondAgent is not linked to the Channel or is disabledGo to Agents → [agent] → Channels and confirm the Channel appears as connected
Channel disconnects automaticallyShort-lived token expired (common with Instagram and WhatsApp WABA)Generate a long-lived token in the platform manager and update the credentials in Timely.ai