Com a integração de Discord, sua loja recebe avisos direto em um canal do servidor, como venda aprovada, recusa ou alteração de status, sem precisar acompanhar o painel o dia todo. A configuração leva poucos minutos e não exige programação.
Pré-requisitos
- Ter um servidor no Discord ou permissão para usar um servidor da equipe.
- Ter permissão de Gerenciar canal para criar webhooks no canal escolhido.
- Ter acesso ao painel Sinnu com permissão para configurar integrações.
Passo 1: escolha ou crie um canal
Use um canal dedicado para as notificações, por exemplo #sinnu-notificacoes. Isso facilita controlar quem enxerga os avisos e evita misturar eventos de pagamento com conversas gerais da equipe.
Passo 2: crie o webhook no Discord
- Clique na engrenagem ao lado do nome do canal para abrir Editar canal.
- No menu lateral, clique em Integrações.
- Clique em Webhooks e depois em Novo webhook.
- Dê um nome ao webhook, como Notificações Sinnu, e escolha um avatar se quiser.
- Clique em Copiar URL do webhook.
Trate a URL como senha
Qualquer pessoa ou sistema com a URL do webhook pode enviar mensagens no seu canal. Não cole essa URL em conversas, planilhas, documentos compartilhados ou capturas de tela públicas.
Passo 3: conecte a URL no painel
- No painel Sinnu, acesse Integrações.
- Localize o card Discord e clique em Conectar.
- Cole a URL copiada no campo URL do webhook do Discord.
Passo 4: escolha os eventos e salve
- Na seção Eventos, ative os avisos que você quer receber.
- Confirme que a opção Integração habilitada está ativada.
- Clique em Conectar para salvar.
Eventos com mensagem no Discord
O conector Discord formata mensagens para estes eventos operacionais de transação:
- Transação aprovada: avisa assim que um pagamento é confirmado.
- Transação recusada: avisa quando uma tentativa de pagamento não foi aprovada.
- Transação atualizada: avisa quando o status de uma transação muda.
Catálogo de eventos
Webhooks por API podem ter outros eventos no catálogo. No Discord, ative os eventos que já têm mensagem formatada para evitar envios sem conteúdo.
Passo 5: teste a integração
Depois de conectar, o card do Discord passa a mostrar a opção Gerenciar. Para testar:
- Clique em Gerenciar no card Discord.
- Escolha um dos eventos ativados.
- Clique em Enviar teste.
- Confira no painel se o envio foi aceito.
- Abra o canal no Discord e confirme se a mensagem de teste apareceu em poucos segundos.
Repita o teste sempre que trocar a URL do webhook ou mudar os eventos ativados. Um envio aceito pelo Discord pode aparecer no painel com status 204.
Segurança
A URL do webhook do Discord é um segredo. Qualquer pessoa que a tenha pode enviar mensagens no canal, mesmo sem acesso à conta do Discord ou da Sinnu.
- Use um canal dedicado e restrinja quem pode vê-lo dentro do servidor.
- Nunca compartilhe a URL do webhook em conversas ou documentos públicos.
- Se desconfiar de vazamento, exclua o webhook no Discord para invalidar a URL.
- Depois de excluir, crie um novo webhook, reconecte a nova URL no painel e envie um teste.
Perguntas frequentes
Preciso programar alguma coisa?
Não. Basta copiar a URL do webhook no Discord e colar no painel Sinnu.
Posso enviar notificações para mais de um canal?
Cada webhook está ligado a um único canal. Para notificar mais de um canal, avalie com o suporte Sinnu as opções disponíveis.
A integração acessa outras informações do servidor Discord?
Não. A integração apenas envia mensagens para o canal escolhido através da URL do webhook. Ela não lê mensagens nem acessa outros dados do servidor.
O que acontece se eu desativar a integração?
A opção Integração habilitada pausa o envio de notificações sem apagar a configuração. Excluir o webhook no Discord invalida a URL por completo.
Como sei se o webhook ainda é válido?
Use Enviar teste no painel. Se a URL foi revogada ou o webhook foi excluído, o teste retorna erro.
Próximo passo
Para integrações desenvolvidas por API, veja o guia Receber webhooks.