Os webhooks enviam informações quando ocorrem determinados eventos que afetam um serviço. No ArcGIS Online, você pode criar webhooks para os serviços da feição que preenchem camadas de feição hospedadas, visualizações de camadas de feição hospedadas e tabelas hospedadas, além de definir os eventos que fazem com que os webhooks sejam invocados.
O item deve ter a configuração de edição Acompanhe as alterações nos dados (adicionar, atualizar, excluir feições) habilitada antes que você possa criar ou gerenciar um webhook para ele.
Criar um webhook
Você pode criar um webhook para uma camada de feição hospedada, uma visualização de camada de feição hospedada ou uma tabela hospedada para usar ativadores e mensagens que podem notificar ou oferecer suporte à automação de tarefas para esses itens.
A infraestrutura para dar suporte a webhooks é configurada fora do ArcGIS. Para obter informações sobre o que você deve configurar antes de criar um webhook e informações sobre quais privilégios são necessários para criar webhooks, consulte Webhooks no ArcGIS Online.
Para criar um webhook para uma camada de feição hospedada, uma visualização de camada de feição hospedada ou uma tabela hospedada, complete as seguintes etapas:
- Entre na organização.
- Abra a página do item da camada de feição hospedada, visualização ou tabela.
- Clique na guia Configurações.
- Vá até a seção Webhooks e clique em Criar webhook.
Se o botão Criar webhook estiver desabilitado, a camada pode não ter a opção Acompanhar alterações nos dados (adicionar, atualizar, excluir feições) habilitada.
Para visualizações, a opção Acompanhar alterações nos dados (adicionar, atualizar, excluir feições) deve estar habilitada na camada de feição hospedada de origem.
- Forneça um nome para o webhook.
- Expanda o menu Eventos e marque todas as caixas de seleção de eventos que você deseja que acionem um webhook.
- Na caixa de texto URL do receptor do webhook, forneça a URL do receptor do webhook.
O receptor do webhook já deve existir e deve ser configurado para se comunicar por meio de uma conexão HTTPS segura.
- Opcionalmente, forneça uma chave secreta para maior segurança.
Você deve configurar a chave secreta no receptor do webhook antes de fornecê-la ao webhook.
- Forneça um nome para o webhook.
O webhook aparece na lista de webhooks deste item.
Gerenciar webhooks
Você pode gerenciar webhooks na guia Configurações da página do item.
Os proprietários dos itens também podem acessar e gerenciar todos os webhooks de sua propriedade em Minhas configurações .
Dica:
Os administradores da organização têm acesso e podem gerenciar todos os webhooks na organização na guia Organização > Configurações > Webhooks. Consulte Gerenciar webhooks na organização para obter mais informações.
O gerenciamento de um webhook associado a uma camada de feição hospedada, exibição de camada de feição hospedada ou tabela hospedada inclui o seguinte:
- Desativar ou ativar o webhook—quando um webhook está inativo, ele não dispara quando os eventos de disparo definidos para ele ocorrem. Você pode desativar todos os webhooks em uma camada temporariamente enquanto executa atualizações automatizadas para evitar encher sua caixa de entrada com mensagens. Ou você pode desativar temporariamente um webhook que dispara para todos os eventos possíveis e deixar outro webhook ativo que dispara em um único gatilho para permitir que você se concentre temporariamente naquele evento.
- Editar o webhook—você pode alterar as configurações do webhook. Por exemplo, é possível adicionar uma chave secreta ou modificar os gatilhos de eventos que acionam o disparo do webhook.
- Excluir o webhook—se um webhook não for mais necessário, você pode excluí-lo.
Anotação:
Os webhooks são imediatamente excluídos. Eles não vão para a lixeira de reciclagem.
Gerenciar um webhook a partir da página do item
Para gerenciar um webhook na página do item da camada de feição hospedada, da visualização da camada de feição hospedada ou da tabela hospedada à qual ele está associado, complete as seguintes etapas:
- Entre na organização.
- Abra a página do item da camada de feição hospedada, visualização ou tabela.
- Clique na guia Configurações e role até a seção de webhooks.
Todos os webhooks associados a este item estão listados aqui.
- Execute uma das seguintes tarefas de gerenciamento:
- Para desativar o webhook, desative o botão de alternar ao lado do nome do webhook.
- Para ativar o webhook, ative o botão de alternar ao lado do nome do webhook.
- Para editar as configurações de um webhook, clique no botão Opções
ao lado do nome do webhook e clique em Editar. Altere o nome, os eventos, a URL do receptor do webhook ou a chave secreta do webhook e clique em Atualizar webhook. - Para excluir um webhook, clique no botão Opções ao lado do nome do webhook e clique em Excluir. Quando solicitado a confirmar, clique em Excluir.
Gerenciar um webhook em Minhas configurações
Para gerenciar webhooks em Minhas configurações, complete as seguintes etapas:
- Entre na organização.
- Clique no seu nome de membro na parte superior do site e clique em Minhas configurações.
- Clique na guia Webhooks.
- Execute uma das seguintes tarefas de gerenciamento:
- Para desativar o webhook, desative o botão de alternar ao lado do nome do webhook.
- Para ativar o webhook, ative o botão de alternar ao lado do nome do webhook.
- Para editar as configurações de um webhook, clique no botão Opções ao lado do nome do webhook e clique em Editar. Altere o nome, os eventos, a URL do receptor do webhook ou a chave secreta do webhook e clique em Atualizar webhook.
- Para excluir um webhook, clique no botão Opções ao lado do nome do webhook e clique em Excluir. Quando solicitado a confirmar, clique em Excluir.