📸 Integração Instagram DM

Automatize as respostas nas DMs do Instagram da sua empresa com IA.

Pré-requisitos

Conta Instagram Business ou Creator — Perfis pessoais não são suportados
Página do Facebook vinculada — O Instagram Business precisa estar vinculado a uma Página do Facebook
Meta App — O mesmo app criado para WhatsApp (ou um novo) em developers.facebook.com
Conta no UpBeez

ℹ️A integração Instagram usa a mesma infraestrutura do Messenger (Graph API da Meta). Você precisa de uma Página do Facebook conectada ao seu perfil Instagram Business.

Configuração Passo a Passo

Passo 1.Vincular Instagram à Página do Facebook

No Instagram, vá em Configurações → Conta → Contas vinculadas → Facebook
Vincule à sua Página do Facebook
Ou no Meta Business Suite, vá em Configurações → Contas → Instagram e conecte

Passo 2.Configurar o Meta App

No Meta App, adicione o produto "Messenger" (Instagram DM usa a mesma plataforma)
Em Messenger → Settings, adicione sua Página
Copie o Page ID e o Page Access Token

⚠️Para DMs do Instagram em produção, seu app precisa passar pelo Meta App Review com a permissão instagram_manage_messages. Em modo desenvolvimento, funciona apenas com usuários adicionados como testers.

Passo 3.Conectar no UpBeez

No UpBeez, vá em 📱 Canais → Instagram
Cole o Page ID e o Page Access Token
Opcionalmente, adicione o App Secret
Clique em "Conectar"

O UpBeez valida que a Página tem uma conta Instagram Business vinculada.

Passo 4.Configurar Webhook na Meta

No Meta App, vá em Messenger → Settings → Webhooks

Cole a Webhook URL fornecida pelo UpBeez:

https://api.upbeez.com/webhooks/instagram/SEU_TENANT_ID

Cole o Verify Token
Subscriba os campos: messages

Passo 5.Testar

Envie uma DM para o perfil Instagram Business conectado. O bot responde automaticamente!

⚙️ Configurações

Configuração	Descrição	Padrão
Auto-reply	Responder automaticamente	Ativado
Typing indicator	Mostrar "digitando..." antes de responder	Ativado
Tamanho da resposta	Máximo de parágrafos (1-5)	3
Mostrar fontes	Exibir de onde veio a informação	Desativado

📡 Endpoints da API

Conectar

POST /tenants/me/instagram/connect
{
  "page_id": "123456789",
  "access_token": "EAAxxxxxxx...",
  "app_secret": "abc123...",     // opcional
  "auto_reply": true
}

Status

GET /tenants/me/instagram/status

Desconectar

POST /tenants/me/instagram/disconnect

Diferenças vs WhatsApp

Instagram usa Page ID + Page Access Token (não Phone Number ID)
Mensagens limitadas a 2000 caracteres (vs 4096 no WhatsApp)
Requer Meta App Review para funcionar em produção com usuários reais
Não suporta mensagens proativas (apenas respostas dentro de 24h após a última mensagem do usuário)

← WhatsApp Messenger →