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 Configuration | The accounts used by the published (live) agent. Available once the agent has been published at least once; until then a warning says so. |
| Draft Configuration | Tagged 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 Username | Required. Step 1: the username of the Instagram account to connect. Next goes to step 2. |
| Meta Developer Setup | Step 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 setup | Must be ticked before Next is enabled. Back returns to step 1. |
| Next | Asks for confirmation, then creates the account. You fill in the credentials on the account screen that follows. |
| |
|---|
| Meta Cloud | The connection type. The dot is green while the channel is on and grey while it is off. |
| Channel on / Channel off | Switches 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. |
| Delete | Asks for confirmation, then removes the Instagram account from the agent. |
Connection
| |
|---|
| Account Username | The username entered during setup. Read-only. |
| Add another Instagram account (person icon) | Opens Add Another Instagram Account. |
| Webhook Secret | Generated 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 block | The 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 ID | Required. Found in the "Generate Access Token" section of your Instagram account in the Meta Developer Console. The info icon shows where. |
| App Secret | Found 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 Token | Required. Generated in the "Generate Access Token" section of the Meta Developer Console. |
Additional Context
| |
|---|
| Additional Context | Optional. 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 session | On 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
| |
|---|
| Update | Asks for confirmation, then saves the account's credentials and settings. |
| Cancel | Discards 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 row | Each 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 account | Opens Add Another Instagram Account. |
Add Another Instagram Account
| |
|---|
| Instagram Username | Required. The handle exactly as it appears on the Instagram profile. |
| Account ID | Required. Digits only, at least 6. Paste fills it from the clipboard. |
| Access Token | Required. Hidden by default. Paste fills it from the clipboard. |
| Additional Context (optional) | The branch or region this account represents. |
| Add Account | Enabled once the required fields are valid. Adds the account. Cancel closes the dialog. |
Related guide: Connect to Instagram