# Connect Instagram to HAPP

> Authorize via Meta, grant permissions — and your AI assistant automatically replies to customers' Direct messages.

- **Integration:** Instagram (Messengers)
- **Page:** https://happ.tools/integrations/instagram
- **Setup guide:** https://docs.happ.tools/ — step-by-step connection instructions, error reference and connection management live in the docs, not on this page.
- **Action:** [Open HAPP Dashboard](https://my.happ.tools/)

## What HAPP requests during OAuth

*Meta permissions*

HAPP requests only the minimum set of permissions — exactly what is needed to handle Direct messages.

- **instagram_manage_messages** — Read and send Direct messages on behalf of the connected Instagram account.
- **pages_manage_metadata** — Access to Facebook Page metadata — required to link Instagram with the HAPP channel.
- **pages_messaging** — Sending messages via the Facebook Page linked to Instagram Business.
- **Real-time channel status** — HAPP shows whether Instagram is online and messages are arriving — without a page reload.
- **Every other channel too** — The same inbox carries Telegram, WhatsApp, Viber and Messenger — Instagram is one row in it.

## What you need to connect

*Before you start*

Instagram Business plus a linked Facebook Page — and the setup takes under three minutes.

1. **HAPP account** — Active account with an assistant configured. No account yet? Sign up at my.happ.tools.
2. **Instagram Business or Creator** — Personal accounts are not supported. Switch to Business or Creator mode in Instagram settings.
3. **Facebook Page** — Instagram Business must be linked to a Facebook Page. Set it up in Instagram → Account → Linked Accounts.
4. **Page admin access** — During Meta OAuth you must authorize with an account that has admin or editor rights on the Facebook Page.

## One assistant, every channel

*Everything else*

This is one of two dozen integrations. Connect the rest of your stack the same way — no code, no migration.

**Messengers** (5 channels): Telegram, Viber, Instagram, Facebook, WhatsApp
**Telephony** (5 carriers): Binotel, Ringostat, Phonet, UniTalk, StreamTelecom
**CRM systems** (5 integrations): SalesDrive, keyCRM, NetHunt, Odoo, Google Sheets

Plus Altegio, Shifio, Zadarma, Qdrant, Custom Messenger and webhooks for anything else you run.

## Frequently asked questions

*FAQ*

Answers to the most common questions about the Instagram integration.

### Why is an Instagram Business account required instead of a personal one?

Meta only opens the Direct Messages API for Instagram Business and Creator accounts. Personal accounts don't have access to the Messaging API — this is a Meta platform limitation, not HAPP.

### Why is a Facebook Page required?

The Instagram Business API is technically built on top of Facebook's Graph API. For HAPP to send and receive DMs, the Instagram Business account must be linked to a Facebook Page — this is Meta's architecture.

### Can customers tell an AI is replying?

It's up to you. The customer sees a message from your Instagram account — the name and avatar remain yours. You can explicitly mention it's an AI assistant at the start, or not mention it.

### What happens when the Meta token expires?

HAPP will notify you and stop processing new DMs. Go to HAPP → Integrations → Instagram and click Re-authorize — the process takes under a minute.

### Can I connect multiple Instagram accounts?

Yes. Each account connects separately via Meta OAuth and creates its own channel in HAPP with its own assistant or operator team.

### Are comments on posts processed?

The current integration works with Direct messages only. Comments on posts are not routed to HAPP — that is a separate Instagram API feature.

### Is it safe to grant permissions to HAPP?

Yes. HAPP requests the minimal required set of Meta permissions and stores tokens encrypted. You can revoke access at any time via Meta Business Suite or in HAPP settings.

## Ready to connect Instagram in 3 minutes?

One Meta OAuth flow and every Direct message lands in HAPP — answered before your competitor opens the app.

[Open HAPP Dashboard](https://my.happ.tools/)