Instagram Direct

Conecte a conta profissional do Instagram ao Aillom MEX para atender automaticamente mensagens recebidas via Direct.

Pré-requisito: Você precisa de uma conta profissional ou de criador do Instagram vinculada a uma Página do Facebook. Contas pessoais não são suportadas pela API da Meta.

1. Criar o Canal Instagram

Crie um canal Instagram vinculado a um Agente do seu Workspace:

curl -X POST https://api.mex.aillom.com.br/api/instagram \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "minha-conta-ig",
    "agent_id": "uuid-do-agente",
    "page_access_token": "TOKEN_DA_PAGINA_FACEBOOK",
    "ig_account_id": "ID_DA_CONTA_IG"
  }'

Resposta:

{
  "id": "uuid-do-canal",
  "name": "minha-conta-ig",
  "status": "active",
  "agent_id": "uuid-do-agente",
  "created_at": "2025-01-01T00:00:00Z"
}

2. Configurar o Webhook na Meta

Após criar o canal, configure o webhook no Meta for Developers para que o Instagram envie as mensagens ao MEX:

Campo	Valor
URL do Webhook	`https://api.mex.aillom.com.br/api/webhook/instagram`
Token de Verificação	Seu `AUTHENTICATION_API_KEY`
Campos a assinar	`messages`, `messaging_postbacks`

Passos no painel Meta:

Acesse developers.facebook.com → seu app
Vá em Webhooks → Instagram → Assinar
Cole a URL e o token acima
Ative os campos messages e messaging_postbacks

3. Verificar o Status

curl https://api.mex.aillom.com.br/api/instagram/{id} \
  -H "Authorization: Bearer SEU_TOKEN"

Status	Descrição
`active`	✅ Canal ativo e recebendo mensagens
`error`	❌ Token inválido ou permissão revogada

4. Fluxo de Mensagens

Quando uma mensagem Direct é recebida:

A Meta envia um evento ao webhook do MEX
O MEX identifica o canal e o Agente vinculado
A IA processa a mensagem com o contexto configurado
A resposta é enviada de volta via API do Instagram

Gerenciar Canais

# Listar todos os canais Instagram do Workspace
curl https://api.mex.aillom.com.br/api/instagram \
  -H "Authorization: Bearer SEU_TOKEN"

# Atualizar agente vinculado
curl -X PUT https://api.mex.aillom.com.br/api/instagram/{id} \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"agent_id": "novo-uuid"}'

# Deletar canal
curl -X DELETE https://api.mex.aillom.com.br/api/instagram/{id} \
  -H "Authorization: Bearer SEU_TOKEN"

Limitações da API

Recurso	Suporte
Mensagens de texto	✅
Imagens recebidas	✅
Áudio recebido	✅
Stories (menções)	❌ Não suportado
Comentários em posts	❌ Não suportado
Grupos	❌ Não existe no Instagram