Skip to main content
Channel of type META_INSTAGRAM. Authorization goes through Instagram OAuth, not Facebook.

​
Requirements

  • An Instagram professional account (Business or Creator) — a personal account will not work
  • The account must be linked to a Meta Business Portfolio
  • Professional account messaging enabled in the Instagram settings
  • To connect from your website: @omnizapi/connect 1.1.1 or later, and the domain registered in the SDK authorized domains. With earlier versions, the window does not return the result to your website.

​
Connecting

The code is the same as for any channel:
The SDK opens a window at instagram.com/oauth/authorize with these scopes: Once the user authorizes, the SDK returns code and accessToken. Forward the whole object to finish the connection.

​
What is different on Instagram

Location and contact do not exist on Instagram. The platform has no such message types — the call will not work. See what each channel accepts.

​
Talking outside the window

Instagram does have a conversation window: 24 hours from the customer’s message, extended to 7 days if you tag the reply with the human agent tag. To talk after that there are two paths, both from Meta:
Instagram has no pre-approved templates. The Graph API message_templates edge exists only on the Page node; no Instagram node exposes it.Omni Z-API connects Instagram through Instagram Login (scopes instagram_business_basic and instagram_business_manage_messages), which maps to the IGUserForIGOnlyAPI node — no templates and no marketing tokens.
What you do have for talking after the window:
If your use case requires templates or recurring marketing messages on Instagram, the path would be connecting through Facebook Login with the account linked to a page — a different integration model, which Omni Z-API does not use today.