Um webhook envia uma solicitação ao seu servidor sempre que algo acontece em Notiondesk, como uma nova mensagem de contato ou um artigo publicado. Use-o para manter seu CRM, data warehouse ou ferramentas internas atualizados sem precisar verificar Notiondesk manualmente.
Antes de começar
- Você é o proprietário do espaço de trabalho ou um administrador. Outras funções não podem abrir a página de Webhooks.
- Você tem um endereço público no seu servidor que começa com
https://, usa um nome de domínio (não um endereço IP) e aceita solicitações POST.
Adicionar um ponto final
- No seu painel de controle do Notiondesk, clique em Configurações .
- Em Espaço de trabalho , abra Desenvolvedores e, em seguida, Webhooks .
- Clique em Adicionar ponto de extremidade .
- Insira a URL que deve receber as solicitações, por exemplo,
https://hooks.acme-support.com/notiondesk.
- Insira um nome que indique a finalidade do endpoint, por exemplo,
CRM sync.
- Em Eventos , clique em Adicionar um evento e selecione os eventos que este endpoint deve receber. Digite na caixa de pesquisa para encontrar um rapidamente.

- Clique em Adicionar ponto de extremidade .
Um único ponto de extremidade recebe eventos do seu espaço de trabalho e de todas as centrais de ajuda nele, portanto, você não precisa de um ponto de extremidade para cada central de ajuda. Você pode adicionar até 10 pontos de extremidade.
Copie a chave secreta de assinatura.
Logo após adicionar o endpoint, Notiondesk exibe seu segredo de assinatura. Seu servidor o utiliza para verificar se cada requisição realmente vem de Notiondesk.
- Clique em Copiar .
- Armazene o segredo em um local onde seu servidor possa lê-lo, como uma variável de ambiente ou um gerenciador de segredos.

- Clique em "Salvei" .
Enviar um evento de teste
- Na página do endpoint, clique em Enviar evento de teste .
- Em Entregas recentes , verifique se o evento de teste exibe uma marca de seleção verde e o código de resposta
200. Isso significa que seu servidor o recebeu.
Clique em uma entrega para ver a resposta do seu servidor e a solicitação Notiondesk enviada. Se o evento de teste falhar, verifique se o seu servidor responde com um código 2xx em alguns segundos.
Perguntas frequentes
Preciso de um ponto de extremidade por central de ajuda?
Não. Um único ponto de extremidade recebe eventos do seu espaço de trabalho e de todas as suas centrais de ajuda. As entregas recentes mostram de qual central de ajuda cada evento foi originado.
Quantos endpoints posso adicionar?
Até 10 por espaço de trabalho.
Quem pode adicionar endpoints?
Somente o proprietário do espaço de trabalho e os administradores podem adicionar, alterar e excluir endpoints.
Quais URLs posso usar?
Um endereço público que começa com https:// e usa um nome de domínio. Endereços em sua rede privada e endereços IP comuns são recusados. Notiondesk não segue redirecionamentos, portanto, insira o endereço final.
E se eu perder o segredo da assinatura?
Abra a página do endpoint e clique em "Girar" em "Segredo de assinatura" . O novo segredo será exibido apenas uma vez e o antigo deixará de funcionar imediatamente; portanto, atualize seu servidor ao mesmo tempo.
Posso alterar os eventos mais tarde?
Sim. Abra a página do endpoint, adicione ou remova eventos em Eventos e clique em Salvar alterações .