Criar um bot

Poste num canal com um webhook, dê comandos de barra à sua comunidade e coloque botões nos cartões.

Três blocos de construção deixam o seu próprio serviço falar na sua comunidade. Eles funcionam juntos: uma única integração pode postar um cartão, responder a um /comando, reagir a um botão e atualizar a própria mensagem.

Os blocos de construção

  • Webhooks: uma URL que posta num canal. O seu serviço manda JSON para ela, e a mensagem aparece com o nome que você deu ao webhook. Feitos para alertas: resultados de CI, monitoramento, tickets.
  • Triggers: os comandos de barra próprios da sua comunidade. Um membro digita /weather, o mssgs manda a mensagem para o seu serviço web, e o que ele responder aparece no canal como um cartão.
  • Botões: embaixo de um cartão, eles abrem um link, mudam o cartão para todos ou executam um dos seus triggers (veja Cartões e botões de bots).

Poste a sua primeira mensagem

1
No app para computador, abra Manage Server → Webhooks da sua comunidade e clique em Add Webhook.
2
Dê um nome, escolha em Channels os canais em que ele pode postar, copie o Webhook Secret e clique em Create Webhook.
3
Clique no ícone de link ao lado do webhook (View webhook URL), escolha um canal em Channel e copie a URL.
4
Faça um POST de JSON para essa URL, assinado com o segredo. A mensagem aparece no canal na hora.
BODY='{"content": "Build #1847 passed on main"}'
SIG=$(printf '%s' "$BODY" | openssl dgst -sha256 -hmac "$MSSGS_WEBHOOK_SECRET" | sed 's/^.* //')
curl -X POST "$MSSGS_WEBHOOK_URL" \
  -H "Content-Type: application/json" \
  -H "X-Mssgs-Signature: sha256=$SIG" \
  -d "$BODY"
Mantenha a URL e o segredo em sigilo. Juntos, eles deixam qualquer pessoa postar naquele canal, então mantenha os dois fora de repositórios públicos e de código que roda no cliente. Uma requisição sem assinatura válida é recusada.

Vai postar a partir do GitHub? Isso não precisa de código: aponte um webhook do GitHub para a URL e cole o segredo no campo Secret dele. Veja integrações.

Adicione um comando de barra

1
Abra Manage Server → Triggers e clique em Create Trigger.
2
Preencha Word to Match, como /weather, e a URL Endpoint do seu serviço web. Em Allowed User Groups, você pode restringir o comando a certos cargos.
3
Quando um membro envia uma mensagem que começa com /weather, o mssgs faz um POST dela para a sua URL. Responda com JSON em até 5 segundos, e a resposta aparece no canal como um cartão.

Precisa de mais tempo? Responda na hora com um cartão com loader e termine o cartão pela callback_url da requisição, que funciona por 30 minutos. O cartão mostra o nome da sua comunidade, e o rodapé diz quem usou qual comando.

Um bot com conta própria

Quer que o bot seja um membro à parte, com nome, avatar e o selo BOT? Crie uma conta de bot vinculada à sua conta e gerencie o bot pelo painel de bots. Com o app para computador conectado na conta do bot, um assistente de IA pode postar cartões com botões pelo servidor MCP do app.

Todos os campos, respostas e códigos de erro estão na documentação para desenvolvedores: webhooks, comandos de barra, cartões de mensagem, botões e atualizações ao vivo. E se você quer um comportamento guiado por IA sem construir nada, o caminho do MCP talvez seja tudo de que você precisa.

Este artigo foi útil?

Não encontrou o que procurava? Teremos prazer em ajudar.

Faça sua pergunta
Artigos relacionados
O que é o MCP do mssgs? Conecte a sua IA (Claude, Cursor e outras) Cartões e botões de bots Segurança e privacidade do MCP

Ainda precisa de ajuda?

Nossa equipe de suporte costuma responder em até 24 horas.

Falar com o suporte