LinkedIn
WhatsApp
Telegrama
Gmail
Perspectivas
Google Agenda
Participe da comunidade do SlackIntrodução
Webhook da API do Instagram
Visão geral dos webhooks
Configuração com o Unipile
Eventos de webhook do Instagram
Gerenciar várias contas do Instagram
Webhooks do Instagram
Pontos de extremidade da API do Instagram
Conclusão
Suporte
FAQs
Os webhooks são o ingrediente secreto por trás da automação em tempo real nas plataformas SaaS modernas. No que diz respeito ao Instagram, o uso de webhooks permite que seu software reaja instantaneamente a novas mensagens sem consultar constantemente a API. Para os editores de software que criam ferramentas de CRM, ATS ou de alcance, isso significa fluxos de trabalho mais rápidos e melhor experiência do usuário. Neste guia, vamos explorar como configurar e otimizar os webhooks da API do Instagram usando a API unificada da Unipile. Pronto para potencializar seu aplicativo com dados instantâneos do Instagram? Vamos nos aprofundar.
O que é o Webhook da API do Instagram?
Um Webhook da API do Instagram é uma ferramenta que permite que seu aplicativo receba atualizações em tempo real de uma nova mensagem do Instagram. Em vez de extrair dados, seu backend é notificado instantaneamente, permitindo uma automação mais rápida e inteligente.
Visão geral dos webhooks
Os webhooks no Unipile são um recurso robusto que permite que seu aplicativo seja informado em tempo real sempre que ocorrerem eventos específicos no sistema Unipile. Ao contrário da sondagem periódica, em que o aplicativo verifica se há atualizações, os webhooks empregam um protocolo de notificação push, garantindo que você receba notificações imediatas quando algo muda. O Unipile facilita a integração do webhook enviando uma solicitação HTTP POST para um URL de sua escolha, permitindo que você configure seu aplicativo para responder prontamente a essas notificações.
Configuração de webhooks do Instagram com o Unipile
Criar webhooks
Há duas maneiras de criar Webhooks:
Usando o método POST /webhooks ou o método SDK apropriado
No painel de controle da Unipile
Novas tentativas
Certifique-se de responder a um código de status 200 em menos de 30 segundos, pois um Webhook faz cinco tentativas de repetição quando o código de resposta HTTP não é igual a 200 em menos de 30 segundos, com um atraso de tempo incremental entre cada tentativa.
Tipos de webhooks
A Unipile oferece quatro tipos de Webhooks:
- Atualizações do status da conta
- Novas mensagens
Webhook Content-Type
Ao contrário do webhook criado a partir do Dashboard, o webhook criado pela API não contém o tipo de conteúdo de cabeçalho JSON por padrão. Alguns aplicativos como Bubble, Make... precisam de um cabeçalho de tipo de conteúdo para receber um bom JSON. Você pode usar o parâmetro "headers" para defini-lo.
curl --request POST \
--url https://{YOUR_DSN}/api/v1/webhooks \
--header 'X-API-KEY: XXXXXXXX' \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--data '{
"request_url": "https://endpoint",
"source": "messaging",
"headers": [
{
"key": "Content-Type",
"value": "application/json"
}
]
}'
Webhook Content-Type
Ao contrário do webhook criado a partir do Dashboard, o webhook criado pela API não contém o tipo de conteúdo de cabeçalho JSON por padrão. Alguns aplicativos como Bubble, Make... precisam de um cabeçalho de tipo de conteúdo para receber um bom JSON. Você pode usar o parâmetro "headers" para defini-lo.
curl --request POST \
--url https://{YOUR_DSN}/api/v1/webhooks \
--header 'X-API-KEY: XXXXXXXX' \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--data '{
"request_url": "https://endpoint",
"source": "messaging",
"headers": [
{
"key" (chave): "Unipile-Auth",
"value": "yourecretkey"
}
]
}'
Autenticação
Você pode adicionar um cabeçalho com uma chave secreta para autenticar o webhook proveniente do Unipile
Configuração de webhooks do Instagram com o Unipile
Registre-se na Unipile
Faça login no painel
Acesse seu espaço de trabalho e gerencie suas contas conectadas.
Recuperação de suas credenciais do Instagram
Para realizar uma autenticação para o Instagram, o usuário precisa do seu INSTAGRAM nome de usuário e senha. No momento, não há suporte para autenticação por meio de credenciais do Facebook.
Autenticação
Faça uma solicitação POST para esse ponto de extremidade da API do Unipile ou use o método SDK apropriado.
curl --request POST
--url https://{YOUR_DSN}/api/v1/accounts
--header 'X-API-KEY: {YOUR_ACCESS_TOKEN}'
--header 'accept: application/json'
--header 'content-type: application/json'
--data '
{
"provider": "INSTAGRAM",
"nome de usuário": "unipile",
"senha": "********"
}
'
Manipular o ponto de verificação 2FA
Se uma conta do Instagram tiver a autenticação de dois fatores ativada, você encontrará um ponto de verificação por meio de um status 202. Aqui está um exemplo de uma resposta de ponto de verificação.
{
"object": "Ponto de controle",
"account_id": "098dez89d",
"checkpoint": {
"type" (tipo): "2FA"
}
}
Nesse caso, uma nova intenção de autenticação é iniciada. Essa intenção dura 5 minutos e os pontos de verificação devem ser resolvidos nesse período.
Resolver o ponto de verificação 2FA
Para resolver o ponto de verificação 2FA, faça uma solicitação POST à API do Unipile usando o ponto de extremidade Solve checkpoint ou use um método SDK fornecendo o parâmetro account_id retornado pela primeira solicitação.
curl --request POST
--url https://{YOUR_DSN}/api/v1/accounts/checkpoint
--header 'X-API-KEY: {YOUR_ACCESS_TOKEN}'
--header 'accept: application/json'
--header 'content-type: application/json'
--data '
{
"provider": "INSTAGRAM",
"account_id": "098dez89d",
"code" (código): "******"
}
'
Tempo limite de intenção de manuseio
Se o usuário levar mais de 5 minutos para resolver o ponto de verificação, a conta não será conectada. Qualquer solicitação subsequente para resolver um ponto de verificação fora do período de 5 minutos responderá primeiro com um 408 - Tempo limite da solicitação e, em seguida, com um 400 - Solicitação incorreta, pois a intenção de autenticação se autodestruirá.
Eventos de webhook do Instagram compatíveis
Webhooks em tempo real para mensagens diretas
Receba alertas instantâneos sempre que uma nova mensagem direta for recebida em uma de suas caixas de entrada conectadas do Instagram. Com o suporte do webhook do Unipile, você pode acionar respostas automáticas, sincronizar conversas no seu CRM ou notificar o membro certo da equipe imediatamente, sem nenhuma sondagem ou atraso.
Solução alternativa para outros eventos: Rastreamento de histórico periódico
Para eventos não suportados por webhooks nativos (curtidas, seguidores, comentários de postagens etc.), é possível verificar regularmente a atividade do usuário, compará-la com dados armazenados anteriormente e detectar quaisquer alterações. Esse método permite registrar interações, rastrear padrões de envolvimento e sincronizar atualizações em seu sistema, garantindo comportamento e análise em tempo real, mesmo sem acesso a webhooks.
Gerenciamento de várias contas do Instagram com webhooks
Fluxos de autenticação e assinatura em escala
O manuseio de várias contas comerciais do Instagram requer um OAuth simplificado ou um sistema de autenticação hospedado. Com o Unipile, cada conta é vinculada com segurança, e as assinaturas de webhook são criadas automaticamente durante a integração. Isso permite que os editores de software ofereçam suporte a várias contas sem lógica de configuração complexa ou chamadas manuais à API.
Roteamento de webhook e mapeamento de contas
Quando os webhooks são acionados, é essencial identificar a qual conta eles pertencem. A Unipile incorpora identificadores de conta na carga útil, para que seu sistema possa rotear eventos com precisão, mesmo ao gerenciar centenas de perfis do Instagram. Isso é ideal para CRMs ou suítes de marketing com caixas de entrada centralizadas ou painéis compartilhados.
Mecanismos de tratamento de erros e novas tentativas
Problemas de rede ou falhas de back-end podem interromper a entrega do webhook. O Unipile implementa a lógica de repetição automática e a fila de eventos para garantir a entrega. Além disso, alertas e registros de falhas estão disponíveis para os desenvolvedores, permitindo que a sua equipe detecte e corrija os problemas antes que eles afetem os usuários finais.
Principais vantagens de usar o Unipile para Webhooks do Instagram
Uma API unificada para todos os canais
O Unipile consolida APIs de mensagens, e-mail e calendário em uma única camada de integração. Em vez de fazer malabarismos com vários provedores para Instagram, WhatsApp, LinkedIn e Gmail, os editores de software podem otimizar o desenvolvimento e a manutenção usando uma estrutura de API consistente. Com o Unipile's API de mídia socialCom o webhook, o manuseio, a autenticação e a implementação de recursos são unificados em todas as plataformas, economizando tempo, reduzindo bugs e acelerando a entrega do produto.
Escalabilidade integrada e arquitetura livre de manutenção
A infraestrutura do Unipile foi projetada para alto volume e baixo atrito. A entrega de webhooks é gerenciada com enfileiramento, novas tentativas e monitoramento, para que sua equipe não precise criar ou manter middleware personalizado. Não importa se você está gerenciando 10 ou 10.000 contas, o Unipile garante um fluxo estável de webhooks com 99,9% de tempo de atividade.
Time-to-Market mais rápido para editores de SaaS
Com pontos de extremidade de webhook pré-configurados, fluxos OAuth e um painel de controle completo para desenvolvedores, o Unipile reduz o tempo de integração. Em vez de semanas de trabalho de back-end, você pode implantar os recursos de webhook do Instagram em poucos dias, permitindo que você se concentre em criar valor para os seus usuários, e não em encanamentos.
| Critérios | Meta APIs | Unipile |
|---|---|---|
| Hora de integrar | Semanas/mêses | 2-3 dias |
| Esforço de desenvolvimento | Alta | Baixo (REST + SDKs) |
| Manutenção | Manual | Totalmente gerenciado |
| Acesso aos recursos | Parcial (após aprovação) | Completo, agora |
| Suporte | Somente autoatendimento | Equipe de tecnologia dedicada |
Desbloqueie Webhooks poderosos do Instagram em seu aplicativo
Os webhooks permitem que seu aplicativo reaja instantaneamente ao que importa no Instagram, sem pesquisas ou atrasos. Por meio da API unificada da Unipile, você pode se inscrever em um rico conjunto de eventos de webhook do Instagram e oferecer aos seus usuários uma experiência em tempo real diretamente no seu CRM, ATS ou ferramenta de divulgação.
Webhooks que você pode aproveitar
-
Mensagens diretas (DM): Notifique os usuários imediatamente quando uma nova mensagem for recebida. Perfeito para acompanhamento de vendas ou engajamento de candidatos.
Benefícios para editores de software
-
Automação em tempo real: Crie sequências inteligentes que reajam instantaneamente a mensagens diretas.
-
Caixa de entrada unificada: Centralize as mensagens do Instagram juntamente com as do LinkedIn, WhatsApp e e-mail.
-
Compatível com nenhum código: Encaminhe facilmente eventos para ferramentas como Make, Zapier ou fluxos de trabalho internos usando a API do Unipile.
Quais recursos do Instagram você pode desbloquear com a API da Unipile?
A API do Instagram da Unipile não fornece apenas webhooks, mas dá aos editores de software acesso a um conjunto completo de pontos de extremidade programáticos. Você pode enviar e receber mensagens diretas. Esses recursos permitem que você crie fluxos de automação de ponta a ponta, enriqueça seu CRM com insights sociais e acione ferramentas avançadas de agendamento ou engajamento, tudo a partir de uma integração unificada.
Recursos do Instagram
Conexão de conta
Hosted Auth: White label para conectar seus usuários finais
Autenticação personalizada: conecte o usuário com credenciais, cookies, sua extensão do Chrome
Mensagens
Enviar e responder mensagens
Listar mensagens, bate-papos e participantes
Histórico de sincronização
Lista de reações
Ler recibos
Enviar anexos de arquivos
Receber anexos de arquivos
Webhooks
Status da conta
Nova mensagem
Nova Reação / Leitura / Evento
Conclusão - Crie fluxos de trabalho do Instagram em tempo real com Webhooks e Unipile
Os webhooks da API do Instagram são um divisor de águas para qualquer plataforma SaaS que queira oferecer experiências em tempo real. Com alertas de mensagens instantâneas, os webhooks permitem que seu produto reaja de forma mais rápida e inteligente. Com a API unificada da Unipile, você pode desbloquear esses recursos em várias contas com o mínimo de esforço, sem se preocupar com dimensionamento, conformidade ou manutenção. Se você estiver criando uma plataforma de CRM, ATS ou de alcance, a integração dos webhooks do Instagram por meio do Unipile significa um tempo de colocação no mercado mais rápido, melhor sincronização de dados e usuários mais felizes.
Pronto para começar? Construa agora com a Unipile e desbloquear todo o poder do Instagram, LinkedIn, e-mail e muito mais!
Webhooks da API do Instagram: Suporte e recursos da Unipile
Assistência dedicada durante a integração
Nossa equipe de suporte está com você em todas as etapas do processo, antes, durante e depois da integração, para garantir uma experiência perfeita. Estamos aqui para fornecer assistência em tempo real, ajudando você a evitar problemas e custos extras.
Recursos abrangentes para desenvolvedores
Nossa API vem com documentação detalhada e código de amostra para simplificar a integração. Esses recursos foram projetados para aprimorar os recursos do seu aplicativo, tornando o processo de envio de mensagens e outros mais fácil e eficiente.
Atualizações e manutenção contínuas
Com atualizações proativas e manutenção regular, nossa API permanece alinhada com os padrões e melhorias mais recentes do Instagram, garantindo um desempenho consistente e minimizando qualquer possível tempo de inatividade.
FAQs
O que é um Webhook da API do Instagram?
Um webhook da API do Instagram é um sistema de notificação por push em tempo real que envia atualizações para o seu back-end quando ocorrem eventos específicos no Instagram, como o recebimento de uma mensagem direta. Ele elimina a necessidade de sondar a API repetidamente.
Em quais eventos posso me inscrever com a API do Instagram da Unipile?
O Unipile suporta eventos de webhook para DMs, projetados para ajudá-lo a automatizar o envolvimento do usuário e a sincronização de dados dentro do seu aplicativo.
Preciso seguir as regras do Meta ao usar o Unipile?
Sim. Embora o Unipile simplifique a integração, todo o uso deve estar em conformidade com os Termos de Serviço do Meta. Isso significa que não há raspagem, spam ou automação não autorizada. Nossa API se concentra exclusivamente na interoperabilidade de mensagens, e toda implementação deve respeitar as políticas oficiais do Meta.
A Unipile está em conformidade com a Lei de Mercados Digitais (DMA)?
Sim. O Unipile foi projetado de acordo com o DMA, permitindo a interoperabilidade de mensagens em canais como Instagram, WhatsApp e Messenger. Não ignoramos a segurança da plataforma nem armazenamos dados não autorizados; em vez disso, fornecemos uma maneira unificada e compatível para que os editores de software integrem recursos de mensagens.
Como faço para autenticar e gerenciar várias contas do Instagram com webhooks?
A Unipile oferece um fluxo semelhante ao OAuth hospedado ou autenticação baseada em credenciais. Depois que as contas são conectadas, as assinaturas de webhook são criadas e roteadas automaticamente usando identificadores de conta exclusivos, tornando o gerenciamento de várias contas escalonável e confiável.
O que acontecerá se meu endpoint de webhook estiver temporariamente indisponível?
O Unipile coloca os eventos em fila e tenta novamente a entrega automaticamente. Você terá acesso a registros de webhooks e relatórios de erros para que possa identificar falhas, corrigir problemas e retomar o processamento de eventos sem perda de dados.
Quão seguros são os dados enviados por meio dos webhooks da API do Instagram?
Todas as cargas de webhooks são entregues por HTTPS e incluem cabeçalhos de validação para verificar a integridade. A Unipile é compatível com o GDPR e segue os padrões do setor para garantir uma comunicação segura e criptografada.
Quanto tempo leva para implementar webhooks do Instagram usando o Unipile?
A maioria das equipes integra o sistema de webhook da Unipile em menos de 2 dias. Com pontos de extremidade prontos para uso, fluxos de geração de token e documentos detalhados, você pode estar pronto para a produção mais rapidamente do que apenas com as APIs nativas do Meta.
Você também pode gostar
WhatsApp API with Python: Send, Receive and Automate Messages
Send How do you send a WhatsApp message with Python? Sending a WhatsApp message from Python is a single HTTP call: POST /api/v1/chats/{chat_id}/messages, with the chat_id you already have from listing chats or from an incoming webhook, and a text field. The endpoint accepts form-encoded and...
WhatsApp API with PHP: The Complete Integration Guide
WhatsApp API PHP Guide WhatsApp API with PHP: The Complete Integration Guide Guzzle and cURL calls to connect a WhatsApp account, send and receive messages, manage groups and run the whole thing inside a Laravel application, without registering a Meta Business app. This is the WhatsApp API in PHP...
Telegram API with Python: Bot API, MTProto and Linked Accounts
Code Tutorial The Python Telegram Bot API with requests The most direct way to call the Telegram Bot API in Python is a plain HTTP call with requests, no wrapper library involved. As of Bot API 10.2 (July 14, 2026), a bot token from BotFather and two parameters are all that sendMessage requires. 1...
BR 
EN 
FR 
ES 
DE 
IT 
NL 
PL 
TR