🚀 Wati AI chegou – A Camada de Inteligência Conversacional para Negócios Modernos Explorar🚀 Wati AI chegou →

Instagram API

Instagram API: comentários via REST, DMs através do MCP.

Leia novos comentários, responda publicamente, envie uma resposta privada e mantenha a conversa fluindo nas DMs. Feito para desenvolvedores e criadores. Prefere o WhatsApp? Insira um link para o seu número na resposta.

  • Na APIComentários: listar, responder, resposta privada, permissões

Última atualização em

O que a Instagram API cobre atualmente

RecursoComo usarStatus
Comentários: listar posts e comentários, responder publicamenteAPI RESTAtivo
Resposta privada a um comentárioAPI RESTAtivo
DM: enviar e receberServidor MCPAtivo via MCP
DMAPI RESTEm breve, lista de espera

Ainda não suportado: ocultar ou excluir comentários e eventos de webhooks do Instagram.

  • 16.000+empresas em mais de 190 países
  • 4,6/5avaliação média no G2
  • OficialParceiro de Negócios da Meta e BSP do WhatsApp
G2 Leader, ChatbotsG2 Leader Mid-Market, ChatbotsG2 Momentum Leader, ChatbotsG2 Most Implementable, WhatsApp MarketingISO 27001GDPR

Um comentário. Mais uma conversa.

Responda publicamente, responda em particular e continue conversando nas DMs. Ou mova o chat para o WhatsApp.

  • Começa com um modeloUm modelo aprovado inicia a conversa, para um cliente ou para 10.000.
  • Continua no chatTexto, mídia e botões assim que o cliente responde.
  • Termina com sua equipeOs webhooks informam o seu código. A caixa de entrada da equipe informa as pessoas.
O produto

Enviar. Responder. Ouvir de volta. Transferir.

InstagramComentários e DMs do Instagram

Crie automação também no Instagram.

Liste comentários em suas publicações, responda publicamente ou envie uma resposta privada.

Transmissões

Mensagens pessoais, enviadas em escala.

Escolha um modelo aprovado e envie para até 10.000 destinatários. Cada pessoa recebe suas próprias variáveis e cada resultado retorna por número.

Mensagens

Responda com mais do que texto.

Dentro da janela de 24 horas, envie textos, imagens, arquivos, botões de resposta e seletores de lista, com um indicador de digitação enquanto você trabalha.

Atualizações de pedidos e alertas

A atualização certa, no momento em que acontece.

Sua loja, sistema de reservas ou faturamento envia um modelo aprovado quando algo muda. Os clientes tocam em um botão ou respondem.

Resposta automática e chatbots

Seu código responde.

O webhook de mensagens traz cada nova mensagem para o seu servidor. Responda com os endpoints de envio ou inicie um chatbot Wati nos planos Pro e Business.

Webhooks

Cada resposta, no momento em que chega.

Os webhooks enviam novas mensagens, confirmações de leitura, cliques e falhas para a sua URL. Sem polling.

Caixa de entrada da equipe

O código começa. As pessoas terminam.

As respostas chegam à caixa de entrada da equipe Wati. Atribua um operador, defina o status e adicione tags via API, para que a pessoa certa assuma o atendimento.

Contatos e segmentos

Seu CRM, espelhado no Wati.

Crie e atualize contatos com atributos personalizados e, em seguida, visualize uma prévia de um segmento antes de enviar mensagens.

Começar

Ativo em três etapas.

  1. Conectar

    Conecte seu número

    Vincule seu número do WhatsApp através do cadastro integrado (Embedded Signup) da Meta dentro do Wati.

  2. Autenticar

    Obtenha um token

    Crie um token de API no Wati e conceda a ele apenas os escopos de que você precisa. Mantenha-o em seu servidor.

  3. Enviar

    Faça sua primeira chamada

    Envie um template aprovado com uma única requisição. Em seguida, adicione um webhook para acompanhar a entrega.

Sua primeira requisição, explicada

Veja o que compõe uma requisição e onde cada parte aparece na mensagem.

  1. Qual comentário

    O comentário ao qual você está respondendo. Você obtém o ID dele ao listar os comentários de uma postagem.

    comment_idno caminho da URL
  2. De qual conta

    Sua conta do Instagram conectada ao Wati.

    channel
  3. Para quem

    A pessoa que escreveu o comentário, obtida do próprio comentário.

    userIduserName
  4. O que enviar

    Texto simples de até 1.000 caracteres ou um template com botões.

    type = texttexttype = template
  5. O que você recebe de volta

    Um status 200 com ok definido como true significa que a resposta privada foi enviada. Use o mesmo cabeçalho Authorization de qualquer outra chamada.

    ok: trueresult: success

POST /api/ext/v3/comments/{comment_id}/privateReply. O comentário e o texto da resposta são exemplos. Consulte a requisição na documentação

Fragment 1 of 5. Traduza apenas o texto dentro deste item.
Código pronto para copiarOcultar o código
POST/api/ext/v3/comments/{comment_id}/privateReply
curl -X POST "https://live-mt-server.wati.io/api/ext/v3/comments/$COMMENT_ID/privateReply" \
  -H "Authorization: Bearer $WATI_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "yourbrand",
    "userId": "17841400000000000",
    "userName": "maya",
    "type": "text",
    "text": "Olá Maya, sim, nós temos. Converse conosco no WhatsApp para ver as opções de envio."
  }'
200 Exemplo de respostaFormato da resposta do esquema da documentação
{
  "ok": true,
  "result": "success"
}
Criado em

O que o Wati resolve para você não ter trabalho.

Onboarding de número

Conecte-se por meio do Cadastro Incorporado da Meta. A conta do WhatsApp Business é registrada em sua empresa.

Status dos modelos

Alterações de aprovação, qualidade e categoria chegam como webhooks para você saber antes que um envio falhe.

Novas tentativas de webhook

Até 144 tentativas, a cada 10 minutos. Se o seu endpoint continuar falhando, o Wati envia um e-mail para você.

Limites de taxa e enfileiramento

Se você for rápido demais, receberá um erro 429 com um cabeçalho Retry-After. As mensagens aceitas ficam aguardando em uma fila.

Transbordo humano

Uma caixa de entrada compartilhada da equipe para as conversas que seu código não deve responder sozinho.

Tokens de API com escopo

O v3 é compatível com tokens com escopo, garantindo que cada integração obtenha apenas o acesso de que precisa.

Envios agendados

Agende o envio de um modelo para mais tarde com uma única chamada. O Wati envia na hora certa.

Estimativa de custo prévia

Estime o custo de uma transmissão antes de enviar qualquer coisa.

Nos bastidores

Os endpoints, por capacidade.

Modelos

Inicie conversas com modelos aprovados, agora ou de forma agendada.

Documentação →
GET/messageTemplatesPOST/messageTemplates/sendPOST/messageTemplates/schedule

Transmissões

Leia os resultados de campanhas e o status por destinatário, além de estimar o custo com antecedência.

Documentação →
GET/broadcastsGET/broadcasts/{broadcast_id}/recipientsPOST/broadcasts/estimate-cost

Mensagens

Responda com texto, mídia ou botões dentro da janela de 24 horas.

Documentação →
POST/conversations/messages/textPOST/conversations/messages/fileViaUrlPOST/conversations/messages/interactivePOST/conversations/typingIndicator

Chatbots Pro+

Liste seus chatbots do Wati e inicie um para um contato.

Documentação →
GET/chatbotsPOST/chatbots/start

Webhooks

Gerencie inscrições e liste os tipos de eventos que você pode receber.

Documentação →
GET/webhooksGET/webhooks/event-typesPUT/webhooks/{id}

Contatos e segmentos

Sincronize contatos e atributos do seu CRM e, em seguida, segmente o público-alvo.

Documentação →
POST/contactsPUT/contactsPOST/segments/evaluate

Caixa de entrada da equipe

Atribua um operador, altere o status, adicione ou remova tags.

Documentação →
PUT/conversations/{target}/operatorPUT/conversations/{target}/statusPOST/conversations/{target_conv}/tags

Instagram

Liste publicações e comentários, responda publicamente ou em privado e verifique permissões.

Documentação →
GET/posts/{post_id}/commentsPOST/comments/{comment_id}/repliesPOST/comments/{comment_id}/privateReplyGET/channels/{channel}/permissions

Os caminhos são relativos a https://live-mt-server.wati.io/api/ext/v3. A criação de um webhook usa o caminho legado POST /{tenantId}/api/v2/webhookEndpoints.

Para agentes de IA, o servidor Wati MCP abrange as mesmas ações do WhatsApp e pode responder a DMs do Instagram e chats do Messenger com texto.

Ver todos os 19 tipos de eventos de webhook do WhatsApp

Mensagens

  • message
  • newContactMessageReceived
  • sessionMessageSent_v2
  • templateMessageSent_v2

Status de entrega

  • sentMessageDELIVERED_v2
  • sentMessageREAD_v2
  • sentMessageREPLIED_v2
  • templateMessageFailed

Modelos e conta

  • templateReviewed
  • templateQualityUpdated
  • templateCategoryUpdated
  • wabaStatusReviewUpdate
  • PhoneNumberQualityUpdatedEvent
  • accountUpdated
  • accountDeleted
  • phoneNumberDeleted

Engajamento e chamadas

  • chatbotTriggered
  • ctaUrlClicked
  • call.status

Versões BSUID de vários eventos também estão disponíveis. Documentação de webhooks

Limites e planos

Limites claros. Publicados.

30 a 100 por 10 s

Envios de modelos

Chamadas para enviar modelos, dependendo do seu plano (Growth, Pro ou Business).

10.000 destinatários

Por chamada de envio v3

Um modelo, até 10.000 pessoas, cada uma com suas próprias variáveis.

24 h de janela

Respostas livres

Texto, mídia e botões exigem uma janela de atendimento ao cliente aberta. Fora dela, envie um modelo.

429 Retry-After

Quando você vai rápido demais

O Wati informa quanto tempo você deve esperar. As mensagens aceitas são processadas em uma fila.

Limites de taxa e disponibilidade do plano em detalhes
Limites de taxa documentados por plano
EndpointGrowthProBusiness
/addContact, /getContacts10 / 10 s10 / 10 s10 / 10 s
/getMessages10 / 10 s10 / 10 s10 / 10 s
/sendTemplateMessage30 / 10 s60 / 10 s100 / 10 s
/sendTemplateMessages30 / 10 s60 / 10 s100 / 10 s

Limites conforme publicados em Erros e Limites de Taxa, listados pelo nome do endpoint. A chamada em lote da v1 aceita até 1.000 contatos. Os endpoints principais de mensagens, modelos e contatos estão disponíveis em todos os planos. A atribuição de equipe, o status do chat, os chatbots e os segmentos personalizados exigem os planos Pro ou Business. A atualização de atributos para vários contatos de uma só vez exige o plano Business. Disponibilidade de endpoints por plano. Para limites maiores, fale com o Wati sobre o seu caso de uso.

FAQ

Perguntas frequentes

A referência completa da API é pública. Leia a documentação

O que a API do Instagram do Wati pode fazer?

Atualmente, a API lista suas publicações no Instagram e seus comentários, retorna a contagem de comentários não lidos, responde a comentários publicamente, envia uma resposta privada para quem comentou e verifica as permissões de comentário da sua conta. Respostas públicas podem ter até 2.200 caracteres e respostas de texto privadas até 1.000.

Posso criar automações no Instagram sem uma grande equipe de engenharia?

Sim. Os endpoints de comentários são chamadas REST simples com um token bearer, permitindo que um construtor de aplicativos de IA os escreva a partir de uma breve descrição. Uma boa primeira construção: verificar novos comentários, responder publicamente e depois enviar uma resposta privada. Se você já usa um agente de IA, o servidor MCP do Wati pode responder a DMs do Instagram com texto.

Como verifico minhas permissões do Instagram antes de responder?

Chame GET /channels/{channel}/permissions com o seu canal do Instagram conectado. A resposta informa se as permissões de comentário foram concedidas e lista quaisquer escopos ausentes, para que sua automação possa parar antes que uma resposta falhe.

Preciso saber programar?

Menos do que antes. Os construtores de aplicativos de IA podem escrever as chamadas de API a partir de instruções em inglês simples, e os exemplos nesta página mostram cada chamada.

Você ainda precisa de um número de WhatsApp conectado ao Wati, um token de API e um modelo aprovado pela Meta antes de poder iniciar uma conversa. Se uma ferramenta de IA escrever o código, verifique se o seu token permanece no servidor.

Quais são os limites de taxa (rate limits) da API?

As chamadas de contato e histórico de mensagens são limitadas a 10 solicitações a cada 10 segundos em todos os planos. Os envios de modelos são limitados a 30, 60 ou 100 solicitações a cada 10 segundos nos planos Growth, Pro e Business. Quando você atinge um limite, recebe um HTTP 429 com um cabeçalho Retry-After. Para limites maiores, entre em contato com o Wati.

Posso enviar uma mensagem para um cliente a qualquer momento?

No WhatsApp, textos de formato livre, mídias e mensagens interativas precisam de uma janela de atendimento ao cliente aberta de 24 horas. Fora dessa janela, inicie a conversa com um modelo aprovado pela Meta.

Qual é a diferença entre o aplicativo WhatsApp Business e a API?

O aplicativo Business é para chats manuais em um telefone, com até 5 dispositivos vinculados e listas de transmissão limitadas a 256 contatos. A API conecta o WhatsApp aos seus próprios sistemas. Você pode enviar modelos aprovados em volume, automatizar respostas, receber webhooks e compartilhar um único número em uma caixa de entrada da equipe.

Quais endpoints estão incluídos no meu plano?

Endpoints essenciais de mensagens, modelos e contatos estão disponíveis em todos os planos. Atribuição de equipe, status de chat, chatbots e segmentos personalizados exigem os planos Pro ou Business. A documentação lista a disponibilidade de endpoints por plano.

Sua primeira mensagem está a apenas uma solicitação de distância.

Comece gratuitamente, conecte seu número de WhatsApp no Wati e faça sua primeira chamada.