API do Messenger e Integração de Webhook para Bots (Tutorial 2026)

Navigate
Back to blog
Published
February 15, 2026
Read time
11 min de leitura
Escrito por
Morgan Huber

Automatizar notificações através de bots de mensagens otimiza fluxos de trabalho de desenvolvimento, permitindo alertas instantâneos quando compilações são concluídas, erros ocorrem ou implantações são finalizadas. Este guia fornece instruções passo a passo para incorporar bots que podem enviar mensagens automatizadas via webhooks em plataformas populares de mensagens. Seja para notificar sua equipe sobre resultados de pipeline CI/CD, alertas de monitoramento de servidor ou conclusão de qualquer processo automatizado, essas integrações tornam isso possível. Cobrimos apenas plataformas com capacidades de integração de bot diretas - alguns mensageiros seguros priorizam a privacidade sobre recursos de automação e são intencionalmente excluídos.

Tabela de Conteúdo

Entendendo a Automação de Bots Baseada em Webhook

Bots baseados em webhook operam em um princípio simples: sua aplicação envia uma solicitação HTTP POST para uma URL específica, e a plataforma de mensagens entrega esse conteúdo a um canal ou usuário. Essa arquitetura é ideal para cenários de automação como:

  • Notificações de build - Alertar quando a compilação for bem-sucedida ou falhar com detalhes do erro
  • Atualizações de implantação - Notificar equipes quando o código chegar ao ambiente de teste ou produção
  • Alertas de monitoramento - Enviar avisos de saúde do servidor ou notificações de inatividade
  • Relatórios programados - Entregar métricas diárias ou resumos de status

O fluxo de trabalho principal envolve:

  1. Criar um bot ou URL de webhook na plataforma alvo
  2. Configurar sua ferramenta de automação (CI/CD, sistema de monitoramento, script personalizado) para enviar solicitações HTTP
  3. Formatar o payload da mensagem de acordo com as especificações da plataforma

Entender como diferentes plataformas de mensagens lidam com segurança e criptografia é crucial para escolher a plataforma certa para suas notificações. Para um mergulho mais profundo nas considerações de segurança específicas de cada plataforma, veja nosso Guia Definitivo sobre Mensageiros em 2026.

Guias de Integração de Bot de Mensagens

Abaixo estão guias passo a passo para cada plataforma que suporta integração de bot baseada em webhook para envio de mensagens automatizadas.

Bot de Webhook do Discord

Como configurar diferentes bots de webhook em 2026 de forma simples e fácil

O Discord oferece uma das implementações de webhook mais simples, não exigindo aplicativo de bot ou tokens de autenticação para o envio básico de mensagens.

Configuração Passo a Passo

  1. Abra as Configurações do Servidor - Clique com o botão direito no nome do servidor e selecione "Configurações do Servidor"
  2. Navegue até Integrações - Clique em "Integrações" na barra lateral esquerda
  3. Crie um Webhook - Clique em "Webhooks" e depois em "Novo Webhook"
  4. Configure o Webhook - Nomeie seu webhook (ex: "Bot de Build"), selecione o canal de destino e, opcionalmente, faça upload de um avatar
  5. Copie a URL do Webhook - Clique em "Copiar URL do Webhook" e armazene-a com segurança

Enviando Mensagens via Webhook

curl -X POST -H "Content-Type: application/json" \
  -d '{"content": "✅ Build concluído com sucesso!\n\nProjeto: MyApp\nBranch: main\nDuração: 3m 42s"}' \
  https://discord.com/api/webhooks/YOUR_WEBHOOK_ID/YOUR_WEBHOOK_TOKEN

Exemplo de Embed Rico para Notificações de Erro

curl -X POST -H "Content-Type: application/json" \
  -d '{
    "embeds": [{
      "title": "❌ Build Falhou",
      "color": 15158332,
      "fields": [
        {"name": "Projeto", "value": "MyApp", "inline": true},
        {"name": "Branch", "value": "feature/login", "inline": true},
        {"name": "Erro", "value": "```TypeError: Cannot read property of undefined```"}
      ],
      "timestamp": "2026-01-15T10:30:00.000Z"
    }]
  }' \
  YOUR_WEBHOOK_URL

Documentação Oficial: Documentação de Webhook do Discord

Bot de Webhook do Slack

Como configurar diferentes bots de webhook em 2026 de forma simples e fácil

O Slack fornece Webhooks de Entrada como parte do sistema de Apps do Slack, oferecendo formatação rica de mensagens e flexibilidade de canal.

Configuração Passo a Passo

  1. Crie um App do Slack - Visite api.slack.com/apps e clique em "Create New App"
  2. Escolha o Método de Criação - Selecione "From scratch" e nomeie seu app (ex: "Notificações de CI/CD")
  3. Habilite Webhooks de Entrada - Navegue até "Incoming Webhooks" na barra lateral esquerda e ative-o
  4. Adicione Webhook ao Workspace - Clique em "Add New Webhook to Workspace"
  5. Selecione o Canal - Escolha o canal onde as notificações devem aparecer e clique em "Allow"
  6. Copie a URL do Webhook - Sua URL única de webhook agora é exibida

Enviando Mensagens via Webhook

curl -X POST -H "Content-Type: application/json" \
  -d '{"text": "✅ Implantação para produção concluída com sucesso!"}' \
  https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXX

Mensagem Block Kit para Notificações Detalhadas

curl -X POST -H "Content-Type: application/json" \
  -d '{
    "blocks": [
      {
        "type": "header",
        "text": {"type": "plain_text", "text": "🚨 Build Falhou"}
      },
      {
        "type": "section",
        "fields": [
          {"type": "mrkdwn", "text": "*Projeto:*\nMyApp"},
          {"type": "mrkdwn", "text": "*Branch:*\nmain"},
          {"type": "mrkdwn", "text": "*Erro:*\n`Module not found`"}
        ]
      }
    ]
  }' \
  YOUR_WEBHOOK_URL

Documentação Oficial: Guia de Webhooks de Entrada do Slack

Bot de Webhook do Microsoft Teams

Como configurar diferentes bots de webhook em 2026 de forma simples e fácil

O Microsoft Teams suporta Webhooks de Entrada para notificações de canal, integrados através do sistema de conectores.

Configuração Passo a Passo

  1. Abra as Configurações do Canal - Navegue até o canal alvo, clique nos três pontos (•••) ao lado do nome do canal
  2. Selecione Conectores - Clique em "Conectores" (ou "Gerenciar canal" e depois "Conectores" em versões mais recentes)
  3. Encontre Webhook de Entrada - Procure por "Incoming Webhook" e clique em "Configurar"
  4. Nomeie seu Webhook - Forneça um nome (ex: "Alertas de Build") e, opcionalmente, faça upload de uma imagem
  5. Crie e Copie a URL - Clique em "Criar" e copie a URL do webhook fornecida

Enviando Mensagens via Webhook

curl -X POST -H "Content-Type: application/json" \
  -d '{"text": "✅ Build #1234 concluído com sucesso na branch main"}' \
  YOUR_TEAMS_WEBHOOK_URL

Cartão Adaptativo para Notificações Ricas

curl -X POST -H "Content-Type: application/json" \
  -d '{
    "type": "message",
    "attachments": [{
      "contentType": "application/vnd.microsoft.card.adaptive",
      "content": {
        "type": "AdaptiveCard",
        "version": "1.2",
        "body": [
          {"type": "TextBlock", "size": "Large", "weight": "Bolder", "text": "❌ Build Falhou"},
          {"type": "FactSet", "facts": [
            {"title": "Projeto:", "value": "MyApp"},
            {"title": "Erro:", "value": "Compilação falhou"}
          ]}
        ]
      }
    }]
  }' \
  YOUR_TEAMS_WEBHOOK_URL

Documentação Oficial: Webhooks de Entrada do Microsoft Teams

Bot do Telegram

Como configurar diferentes bots de webhook em 2026 de forma simples e fácil

O Telegram oferece uma poderosa API de Bot que permite enviar mensagens programaticamente. Diferentemente dos webhooks, você envia solicitações diretamente para a API do Telegram.

Configuração Passo a Passo

  1. Crie um Bot via BotFather - Abra o Telegram e procure por @BotFather
  2. Inicie um Novo Bot - Envie o comando /newbot
  3. Nomeie Seu Bot - Siga as instruções para definir o nome de exibição e o nome de usuário (deve terminar com "bot")
  4. Salve o Token da API - BotFather fornecerá um token de API como 123456789:ABCdefGHIjklMNOpqrsTUVwxyz
  5. Obtenha o ID do Chat - Adicione o bot ao seu grupo/canal, envie uma mensagem e depois visite https://api.telegram.org/bot<TOKEN>/getUpdates para encontrar o ID do chat

Enviando Mensagens via API de Bot

curl -X POST \
  "https://api.telegram.org/bot/sendMessage" \
  -d "chat_id=" \
  -d "text=✅ Build concluído com sucesso!%0A%0AProjeto: MyApp%0ABranch: main" \
  -d "parse_mode=HTML"

Mensagem Formatada com HTML

curl -X POST \
  "https://api.telegram.org/bot/sendMessage" \
  -H "Content-Type: application/json" \
  -d '{
    "chat_id": "",
    "text": "❌ Build Falhou\n\nProjeto: MyApp\nBranch: main\nErro: Module not found",
    "parse_mode": "HTML"
  }'

Documentação Oficial: API de Bot do Telegram

Bot de Webhook do Mattermost

Como configurar diferentes bots de webhook em 2026 de forma simples e fácil

O Mattermost é uma alternativa de código aberto ao Slack com excelente suporte a webhook, ideal para comunicação de equipe auto-hospedada.

Configuração Passo a Passo

  1. Acesse Integrações - Clique no menu hambúrguer e depois em "Integrações"
  2. Crie um Webhook de Entrada - Selecione "Incoming Webhooks" e depois "Add Incoming Webhook"
  3. Configure o Webhook - Defina título, descrição e selecione o canal padrão
  4. Salve e Copie a URL - Clique em "Save" e copie a URL do webhook

Enviando Mensagens via Webhook

curl -X POST -H "Content-Type: application/json" \
  -d '{"text": "✅ Build concluído com sucesso!"}' \
  https://your-mattermost-server.com/hooks/YOUR_WEBHOOK_ID

Mensagem com Anexo Rico

curl -X POST -H "Content-Type: application/json" \
  -d '{
    "attachments": [{
      "fallback": "Build Falhou",
      "color": "#FF0000",
      "title": "❌ Build Falhou",
      "fields": [
        {"short": true, "title": "Projeto", "value": "MyApp"},
        {"short": true, "title": "Branch", "value": "main"},
        {"short": false, "title": "Erro", "value": "```Module not found```"}
      ]
    }]
  }' \
  YOUR_WEBHOOK_URL

Documentação Oficial: Webhooks de Entrada do Mattermost

Bot Matrix/Element

Como configurar diferentes bots de webhook em 2026 de forma simples e fácil

O Matrix é um protocolo aberto para comunicação descentralizada, sendo o Element o cliente mais popular. A integração de bot requer o uso da API Cliente-Servidor do Matrix.

Configuração Passo a Passo

  1. Crie uma Conta de Bot - Registre uma nova conta Matrix para seu bot em seu homeserver ou matrix.org
  2. Obtenha o Token de Acesso - Faça login e recupere o token de acesso do Element: Configurações → Ajuda e Sobre → Avançado → Token de Acesso
  3. Obtenha o ID da Sala - Entre na sala alvo com seu bot, depois encontre o ID da sala em Configurações da Sala → Avançado
  4. Convide o Bot para a Sala - Certifique-se de que a conta do bot tenha entrado na sala onde você deseja enviar mensagens

Enviando Mensagens via API Matrix

curl -X PUT \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"msgtype": "m.text", "body": "✅ Build concluído com sucesso!"}' \
  "https://matrix.org/_matrix/client/r0/rooms/YOUR_ROOM_ID/send/m.room.message/$(date +%s)"

Mensagem Formatada com HTML

curl -X PUT \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "msgtype": "m.text",
    "body": "Build Falhou\nProjeto: MyApp\nErro: Module not found",
    "format": "org.matrix.custom.html",
    "formatted_body": "
❌ Build Falhou
Projeto: MyApp
Erro: Module not found
"
  }' \
  "https://matrix.org/_matrix/client/r0/rooms/YOUR_ROOM_ID/send/m.room.message/$(date +%s)"

Dica: Para desenvolvimento de bot Matrix mais fácil, considere usar bibliotecas como matrix-nio (Python) ou matrix-bot-sdk (JavaScript).

Documentação Oficial: Especificação da API Cliente-Servidor Matrix

Bot do WhatsApp Business

Como configurar diferentes bots de webhook em 2026 de forma simples e fácil

O WhatsApp oferece a API Business para mensagens automatizadas, embora exija verificação de negócio e tenha configuração mais complexa que outras plataformas.

Configuração Passo a Passo

  1. Crie uma Conta de Negócios Meta - Visite business.facebook.com e crie uma conta de negócios
  2. Configure o WhatsApp Business - Navegue até developers.facebook.com, crie um aplicativo e adicione o produto WhatsApp
  3. Configure um Número de Telefone - Adicione um número de telefone para seu bot (números de teste disponíveis para desenvolvimento)
  4. Obtenha o Token de Acesso - Gere um token de acesso permanente no painel do aplicativo
  5. Verifique o Negócio - Complete a verificação de negócio para uso em produção

Enviando Mensagens via API Cloud

curl -X POST \
  "https://graph.facebook.com/v17.0/YOUR_PHONE_NUMBER_ID/messages" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "messaging_product": "whatsapp",
    "to": "RECIPIENT_PHONE_NUMBER",
    "type": "text",
    "text": {"body": "✅ Build concluído com sucesso!"}
  }'

Importante: O WhatsApp requer modelos de mensagem para iniciar conversas com usuários. Você só pode enviar mensagens de formato livre dentro de 24 horas após a interação do usuário. Para notificações automatizadas, crie e aprove modelos de mensagem primeiro.

Documentação Oficial: Documentação da API Cloud do WhatsApp

Bot do Facebook Messenger

Como configurar diferentes bots de webhook em 2026 de forma simples e fácil

Os bots do Facebook Messenger exigem um aplicativo do Facebook e uma página, com mensagens enviadas através da Send API.

Configuração Passo a Passo

  1. Crie um Aplicativo Facebook - Visite developers.facebook.com e crie um novo aplicativo (selecione o tipo "Business")
  2. Adicione o Produto Messenger - No painel do seu aplicativo, clique em "Add Product" e selecione Messenger
  3. Conecte uma Página do Facebook - Vincule uma Página do Facebook ao seu aplicativo (crie uma se necessário)
  4. Gere um Token de Acesso à Página - Nas configurações do Messenger, gere um token para sua página
  5. Obtenha o PSID - Os usuários devem enviar mensagem para sua página primeiro; capture o ID com escopo de página (PSID) deles a partir de eventos de webhook

Enviando Mensagens via Send API

curl -X POST \
  "https://graph.facebook.com/v17.0/me/messages" \
  -H "Content-Type: application/json" \
  -d '{
    "recipient": {"id": "USER_PSID"},
    "message": {"text": "✅ Build concluído com sucesso!"},
    "access_token": "YOUR_PAGE_ACCESS_TOKEN"
  }'

Nota: O Facebook Messenger tem políticas rigorosas sobre mensagens automatizadas. Os bots só podem enviar mensagens promocionais dentro de 24 horas após a interação do usuário. Para notificações fora desta janela, você precisa solicitar tags específicas de mensagem ou usar o recurso de notificação única.

Documentação Oficial: Documentação da Plataforma Facebook Messenger

Mensageiros Sem Suporte Fácil para Bots

Os seguintes mensageiros priorizam privacidade e segurança sobre recursos de automação, tornando a integração de bot baseada em webhook impossível ou impraticável:

  • Signal - Sem API oficial de bot. O Signal prioriza criptografia ponta a ponta e privacidade do usuário, evitando deliberadamente recursos de automação que poderiam comprometer a segurança.
  • Session - Mensageiro descentralizado sem infraestrutura para bots. A arquitetura de roteamento onion torna impraticável o envio automatizado de mensagens.
  • Briar - Mensageiro peer-to-peer projetado para ativistas e jornalistas. A ausência de infraestrutura de servidor significa ausência de capacidade de webhook.
  • Wire - Embora o Wire tenha alguns recursos de API empresarial, não há um sistema simples de webhook para notificações automatizadas.
  • Wickr - Focado em empresas sem API pública para bots. A automação requer o Wickr Enterprise com integração personalizada.
  • SimpleX - Design com prioridade na privacidade sem identificadores de usuário torna a integração de bot arquitetonicamente incompatível.
  • Threema - Oferece o Threema Gateway para empresas, mas é um serviço pago que requer contratos, não uma configuração simples de webhook.
  • Viber - Tem uma API de bot, mas requer aprovação de conta comercial e é projetado principalmente para atendimento ao cliente, não para notificações de desenvolvedor.
  • LINE - Oferece API de Mensagens, mas requer verificação de conta comercial e é complexa para casos de uso simples de notificação.
  • WeChat - A API de Conta Oficial existe, mas requer registro comercial chinês e aprovação governamental.

Para necessidades de comunicação segura onde essas plataformas são preferidas, considere usá-las junto com uma plataforma suportada para automação, ou explore nosso guia sobre como manter mensagens privadas verdadeiramente seguras.

Exemplo de Implementação Prática

Aqui está um exemplo completo em Node.js que envia notificações de build para múltiplas plataformas simultaneamente:

const axios = require('axios');

const notifiers = {
  discord: async (message, webhookUrl) => {
    await axios.post(webhookUrl, { content: message });
  },

  slack: async (message, webhookUrl) => {
    await axios.post(webhookUrl, { text: