Instagram Integration Guide
Connect an Instagram Professional account to your AI Agent and automate direct message (DM) conversations. Authentication is handled via an Instagram OAuth login flow — no manual token entry required. Once connected, all incoming Instagram DMs to your account are routed to your AI Agent automatically.
Prerequisites
Before you begin, confirm:
- You have an Instagram Professional account — either a Business or Creator account. Personal Instagram accounts are not supported.
- To switch an existing account: go to your Instagram profile settings and choose Switch to Professional Account.
1. Open the Instagram setup
- In the Kaily dashboard, navigate to Deploy.
- Find the Instagram card and click Setup.
The setup panel shows an Instagram Credentials section on the left and setup instructions on the right.
2. Log in with Instagram
- Click Log in with Instagram.
- An Instagram OAuth popup opens. Complete the Instagram login.
- When prompted, approve the requested permissions:
instagram_business_basic— allows Kaily to access your Instagram Professional account.instagram_business_manage_messages— allows the AI Agent to send and receive Instagram DMs on your behalf.
Only Business and Creator Instagram accounts can be connected. If you log in with a personal account, no eligible account will appear in the selection list.
3. Select your Instagram account
After approving permissions, Kaily fetches the eligible Professional accounts linked to your login and displays them.
- Review the list of accounts (showing username and account type).
- Click Connect next to the account you want to link to this AI Agent.
If no accounts appear: The account logged in may be a personal account. Switch it to a Business or Creator account in Instagram settings and then try again.
If the selected account is already connected to a different AI Agent, a confirmation dialog will appear. Click Proceed to reassign it to this agent. This disconnects the previous agent.
4. Verify the connection
Once an account is connected, the Instagram Credentials section shows:
- Instagram Username — the
@usernameof the connected account (read-only, with a copy button). - The account's profile picture is shown as an avatar.
All new DMs sent to this Instagram account are now routed to your AI Agent.
5. Configure Auto Suggestions (optional)
After connecting, you can enable Auto Suggestions:
- Toggle Auto Suggestions on to have your AI Agent automatically suggest quick follow-up replies after each response.
- Toggle it off to disable this behavior.
Changes take effect immediately.
6. Disconnect or switch accounts
To connect a different Instagram account or remove the integration:
- Click Reset Credentials in the top-right of the Instagram Credentials section.
- The account is immediately disconnected.
- You can then log in again and select a different account.
Resetting credentials disconnects Instagram DMs for the current account. Users will not receive AI Agent responses until you reconnect.
Token refresh
Instagram access tokens expire after approximately 60 days. Kaily automatically refreshes the token in the background before it expires. No action is required from you.
If a refresh fails (for example, if you revoke app permissions from Instagram settings), a Reconnect required notice will appear. Click Log in with Instagram again to re-authenticate.
Troubleshooting
| Symptom | Fix |
|---|---|
| No accounts appear after login | The account is likely a personal account. Convert it to Business or Creator in Instagram settings. |
| Popup is blocked | Allow popups for the Kaily dashboard domain in your browser settings. |
| "Instagram authorization could not be verified" error | Close the popup and try again. Make sure popups are not blocked. |
| DMs not received by the AI Agent | Check the connected username matches your target account. Reset credentials and reconnect if needed. |
| "Reconnect required" banner | Your access token was revoked or expired. Click Log in with Instagram to reconnect. |