Para: Administradores
Configure um webhook para a atividade do feed.
Envie uma mensagem ao seu sistema sempre que uma publicação, comentário ou anexo for adicionado, alterado ou excluído do feed.
Neste artigo8 seções
O webhookWebhook Um endereço que você fornece ao hub para que ele possa enviar uma mensagem aos seus sistemas sempre que uma publicação ou comentário no feed for alterado. envia uma mensagem ao seu próprio sistema, sempre que algo acontece no FeedAlimentação Linha do tempo das publicações sobre um caso, onde o escritório compartilha notícias e todos os envolvidos no caso podem comentar. de um caso, como uma nova postagem ou comentário. Cada mensagem é encriptada, então o sistema que recebe essa mensagem precisa de um código desenvolvido por um programador para poder decifrá-la.
Webhooks abertos
Vá para Integração › Webhooks e selecione NOVO.
Insira o endereço
Abaixo de URL, digite o endereço do seu sistema que recebe as mensagens. Por exemplo: https://crm.example.com/hooks/caseactive. O endereço deve começar com https:// ou http:// e deve ser acessível pela internet. As letras maiúsculas são mantidas durante a digitação.
Descrição é opcional: uma nota para a sua equipe, como posts relacionados aos casos no nosso CRM.
Escolha os eventos
Abaixo de Eventos, selecione cada um dos elementos que devem enviar uma mensagem, como a postagem foi criada e o comentário postado é criado. Existem dez desses elementos: eles referem-se a posts, comentários sobre posts e arquivos que são adicionados ou removidos de algum dos locais mencionados. Consulte os eventos do webhook e os conteúdos enviados por eles indica o que cada um desses elementos envia.
Ligue e economize
Ativo começa a funcionar. Deixe-o ativo: um webhook inativo não recebe nada, e o que ele perde não será enviado posteriormente. Escolha SALVAR. “Webhook adicionado” será exibido.
Guarde o segredo
A janela Webhook secreto exibe a chave secreta do webhook: a chave privada que permite a abertura de cada mensagem enviada pelo webhook. Essa informação é exibida apenas uma vez. Selecione Baixar como arquivo .pem para salvá-la como um arquivo, ou Copiar para a área de transferência para copiar toda a informação, incluindo as linhas separadoras. Transfira essa informação para o seu desenvolvedor de forma segura, por exemplo, através de um gerenciador de senhas. Depois, selecione Feito.
Faça o teste
Adicione uma breve mensagem a um caso que não tenha nenhum cliente real associado a ele. Pode ser um dos dois exemplos de casos que o seu desenvolvedor começou a trabalhar. O desenvolvedor verifica se a mensagem foi recebida e se o segredo está correto.
O que acontece a seguir?
Sempre que um evento selecionado ocorre em qualquer caso no seu hub, o webhook envia uma mensagem ao seu sistema. A mensagem pode ser proveniente da sua equipe, de um cliente, do Assistente VirtualAssistente Virtual Um membro de equipe automatizado que publica mensagens de boas-vindas, atualizações e posts de apresentação para a empresa; suas publicações exibem um selo de Assistente Virtual., ou de uma chave de API. Ninguém mais é informado sobre isso.
Se duas entregas consecutivas falharem, o webhook será interrompido e cada administrador receberá um e-mail. Para corrigir esse problema, consulte Corrija o webhook que não está enviando mais mensagens. Para alterar o endereço ou os eventos relacionados ao webhook, clique no ícone de lápis, Editar webhook, na linha correspondente ao webhook. O secret key permanecerá o mesmo.
Se algo der errado
- O limite de Webhooks foi atingido. O seu hub pode ter cinco webhooks. Apague um dos webhooks que você não usa mais. Para isso, selecione o ícone do recipiente onde os webhooks serão armazenados. Excluir webhook, Na sua linha, então. Excluir. Ele para imediatamente e não pode ser recuperado.
- A URL está incorreta. Por exemplo: https://example.com/hook Digite o endereço completo, começando com https:// ou http://. Um endereço que funcione apenas no seu próprio computador não será aceito.
- Você perdeu o segredo. Não é possível mostrar isso novamente. Adicione um novo webhook com o mesmo endereço e eventos. Dê o segredo desse novo webhook ao seu desenvolvedor. Depois, exclua o antigo webhook.