A conexão com o Instagram é feita por OAuth na tela do próprio Instagram: você entra com a sua conta profissional, autoriza o acesso e, de volta à Toca, escolhe o perfil no card. A integração atende contas profissionais — Business ou Creator — e cobre o conteúdo orgânico do perfil.
Antes de começar
- A conta precisa ser profissional — Business ou Creator. Conta pessoal não tem acesso à API do Instagram; converta o perfil antes de conectar (confirme na documentação oficial do Instagram como fazer a conversão).
- O login é feito na tela do próprio Instagram, com a conta profissional — não é preciso ter uma Página do Facebook vinculada.
- O card aparece marcado como Beta, e a integração pode estar em liberação gradual — se o card não aparecer para a sua conta, fale com o suporte.
Passo a passo
- Acesse
Configurações → Integraçõesna Toca. - Localize o card Instagram e clique em Autorizar.
- Entre com a sua conta profissional na tela de login do Instagram e autorize o acesso.
- De volta à Toca, o card exibe um seletor de conta Instagram, com o @ do perfil autorizado. Escolha a conta que a Toca deve acompanhar.
- Ao selecionar, a escolha é salva ("Conta Instagram atualizada.") e a integração fica ativa.
O que a Toca acessa
Com a conexão ativa, a Toca lê o conteúdo orgânico do Instagram: posts, reels e stories; alcance, visualizações, curtidas, comentários, salvamentos, compartilhamentos e interações; seguidores, follows e unfollows; visitas ao perfil; demografia da audiência; e conversas e mensagens diretas. Alterações — como publicar post, reel e story, responder, ocultar e excluir comentário, ligar ou desligar comentários, responder por mensagem direta e excluir publicação — só acontecem mediante sua aprovação explícita, pedido a pedido, dentro do chat.
Manutenção da conexão
A autorização gera um token de longa duração, válido por cerca de 60 dias, que a Toca
renova automaticamente quando a validade se aproxima do fim. A conexão permanece ativa
até você desconectar a integração na Toca ou revogar o acesso do aplicativo no
Instagram — nesse caso, refaça a autorização pelo card em
Configurações → Integrações.
Problemas comuns
- "Nenhuma conta encontrada" — o login usado não corresponde a uma conta profissional. Verifique se o perfil é Business ou Creator e refaça a autorização.
- O card Instagram não aparece — a integração pode estar em liberação gradual — se o card não aparecer para a sua conta, fale com o suporte.
- Métricas antigas não aparecem — os insights de conta do Instagram cobrem no máximo os últimos 90 dias, e cada consulta lê até 30 dias por vez. Não é problema de conexão.
- Quero dados de anúncios que aparecem no Instagram — campanha paga é assunto da integração Meta Ads; esta integração cobre o conteúdo orgânico do perfil.