Instagram

Open in CMS

The Instagram screen connects Instagram business accounts to your agent through Meta Cloud, so people can chat with the agent in Instagram direct messages. Found in the agent sidebar under Channels β†’ Instagram.

Published and Draft Configuration

Published ConfigurationThe accounts used by the published (live) agent. Available once the agent has been published at least once; until then a warning says so.
Draft ConfigurationTagged Optional. Accounts for the draft version of the agent, so you can test with a separate account before publishing. Available only when the agent has a draft version.

Each tab is configured separately and works the same way, as described below.

Connect Instagram

Shown when a tab has no account yet. Setup takes two steps.

Instagram Account UsernameRequired. Step 1: the username of the Instagram account to connect. Next goes to step 2.
Meta Developer SetupStep 2: a checklist of what to do in the Meta Developer Console first: create a Meta Developer account and an app with the Instagram use case, add an Instagram Tester, get the credentials (Account ID, App Secret, Access Token), register the webhook callback URL, put the app in Published mode (which needs Meta's App Review), and send a test direct message.
Yes, I have completed the Meta Developer setupMust be ticked before Next is enabled. Back returns to step 1.
NextAsks for confirmation, then creates the account. You fill in the credentials on the account screen that follows.

Account Header

Meta CloudThe connection type. The dot is green while the channel is on and grey while it is off.
Channel on / Channel offSwitches the channel on or off. Off means incoming messages are ignored and the agent does not reply; credentials and webhook settings are kept. Switching off the published configuration asks for confirmation first, because the live agent stops replying at once.
DeleteAsks for confirmation, then removes the Instagram account from the agent.

Connection

Account UsernameThe username entered during setup. Read-only.
Add another Instagram account (person icon)Opens Add Another Instagram Account.
Webhook SecretGenerated for you and hidden by default; use the eye icon to show it. Regenerate creates a new secret, which only takes effect after you click Update.
Registration blockThe Account Username and the Webhook Configuration URL, with a copy button. Send these to your provider to register the channel. The integration stays inactive until all inputs are complete.

API Credentials

From your Meta app configuration. Stored encrypted.

Account IDRequired. Found in the "Generate Access Token" section of your Instagram account in the Meta Developer Console. The info icon shows where.
App SecretFound in the Instagram Business use case settings of your Meta app. Hidden by default. Only needed for the account whose webhook URL is registered with Meta.
Access TokenRequired. Generated in the "Generate Access Token" section of the Meta Developer Console.

Additional Context

Additional ContextOptional. Describe the branch or region this account represents, for example "This account is for our Sudirman branch located in Denpasar, Bali.", so the agent can answer location-specific questions correctly for this account only.

Session Management

Ask user to end sessionOn by default. The agent asks the user whether to end the session after a period of inactivity.
Delay Before Ask More (seconds)Required. How long to wait before asking whether the user has more questions. Default 300 (5 minutes). Disabled while Ask user to end session is off.
Delay Before End Session (seconds)Required. How long to wait before asking whether the user wants to end the session. Default 600 (10 minutes). Disabled while Ask user to end session is off.

Saving

UpdateAsks for confirmation, then saves the account's credentials and settings.
CancelDiscards your unsaved changes.
Documentation link"Need further guidance?" opens the Instagram channel setup guide (PDF).

Other Instagram Accounts

Several Instagram accounts can share the webhook configured above, for example one account per branch.

Account rowEach extra account shows its username with its own Account ID, Access Token and Additional Context (optional), and is saved (disk icon) or deleted (bin icon) on its own. Deleting asks for confirmation.
Add Instagram accountOpens Add Another Instagram Account.

Add Another Instagram Account

Instagram UsernameRequired. The handle exactly as it appears on the Instagram profile.
Account IDRequired. Digits only, at least 6. Paste fills it from the clipboard.
Access TokenRequired. Hidden by default. Paste fills it from the clipboard.
Additional Context (optional)The branch or region this account represents.
Add AccountEnabled once the required fields are valid. Adds the account. Cancel closes the dialog.

Related guide: Connect to Instagram