Desenvolvedores
O SquadCall tem duas formas de ligar um programa seu a um servidor. Elas servem para coisas diferentes.
Webhook ou bot?
Um webhook é uma URL ligada a um canal: tudo o que você manda para ela num POST aparece no canal. Não tem conta, token nem conexão. Envia e cuida das mensagens que ele mesmo mandou: lista, lê, edita e apaga. Não lê o resto do canal.
Um bot é uma conta do servidor, com a marca BOT. Ele envia, lê, edita e apaga as próprias mensagens, reage, cria e lê tópicos e recebe em tempo real o que acontece (mensagens, reações, cliques em botões, entradas e saídas). É o que se usa para comandos, moderação e qualquer coisa que precise responder.
| Webhook | Bot | |
|---|---|---|
| O que é | uma URL para um canal | uma conta própria no servidor |
| Enviar mensagens | sim | sim |
| Ler mensagens | só as que ele enviou | sim |
| Editar e apagar | as que ele enviou | as próprias mensagens |
| Reagir | não | sim |
| Tópicos | cria um tópico ao postar | cria, lê, renomeia, arquiva e apaga |
| Receber eventos | não | sim (conexão em tempo real ou URL assinada) |
| Credencial | a própria URL (guarde como senha) | token nsc_... |
| Onde atua | um canal | onde as permissões deixarem |
| Compatível com o Discord | sim, o mesmo JSON | embeds e botões no mesmo formato |
| Bom para | alertas, CI, deploys, scripts | comandos, enquetes, moderação, integrações |
Na dúvida, comece pelo webhook: leva um minuto. Se depois precisar ler ou responder, migre para um bot.
Por onde começar
- Webhooks: criar a URL e publicar com um
curlou com a lib. - Bots: criar a integração, conectar e tratar eventos, com a API HTTP completa.
- Formatação: Markdown, embeds e botões, iguais para os dois.
- Cosméticos: medidas e regras de molduras, placas, banners, fundos, efeitos e auras.
Tudo é criado no próprio SquadCall: menu do servidor, Integrações (só o dono e os administradores veem). A API fica em https://squadcall.gg/chat-api/v1.