Como usar o serviço de Webhook da systeme.io

Neste artigo, você vai aprender como configurar e usar webhooks na systeme.io para otimizar seus negócios.

1. O que é um Webhook?

Webhooks são uma ferramenta poderosa para automatizar a transferência de dados entre vários aplicativos/plataformas, permitindo que os usuários recebam notificações em tempo real sobre eventos específicos. Eles facilitam a integração da systeme.io com outros serviços.

Quando um evento predefinido ocorre, como um novo pedido ou a adição de um inscrito, a systeme.io envia automaticamente os dados para uma URL específica. Isso permite que você integre sua empresa com outras ferramentas, automatize tarefas e melhore a experiência do cliente. Nosso serviço de webhook oferece recursos específicos, permitindo que os desenvolvedores recebam notificações em tempo real.

Se quiser saber mais sobre como isso funciona, você pode conferir nossa documentação.

2. Configuração de webhooks na systeme.io:

Para configurar um webhook em sua conta da systeme.io, siga estes passos simples:

Em sua conta da systeme.io, clique em sua foto de Perfil e depois em Configurações (1).

Clique em Webhooks (2) e depois em Criar (3) para começar a criar um webhook.

Insira um nome e uma URL de Webhook para onde os dados serão enviados. Em seguida, insira a chave secreta do seu webhook.

O botão Ativo controla se o webhook está ativado ou desativado.

Observação: Você deve fornecer o endpoint da URL do servidor para receber solicitações de webhook. Isso requer um endpoint HTTPS seguro capaz de lidar com essas solicitações. Você deve usar HTTPS para garantir a segurança e a criptografia dos dados.

Selecione os eventos específicos que acionarão o webhook na systeme.io e clique em Salvar (4) para confirmar a criação.

Assim que essas etapas forem concluídas, seu webhook estará ativo, permitindo que você receba atualizações em tempo real para os eventos selecionados em sua conta da systeme.io.

3. Tipos de eventos suportados para seus webhooks:

  • Contato criado: Acionado quando um novo contato é criado em sua conta da systeme.io.
  • Tag adicionada ao contato: Acionado quando uma tag é adicionada a um contato existente em sua lista de contatos.
  • Tag removida do contato: Acionado quando uma tag é removida de um contato existente.
  • Inscrição: Acionado quando um contato se inscreve através de um formulário de opt-in.
  • Nova venda: Acionado quando um cliente realiza uma compra.
  • Venda cancelada: Acionado quando uma assinatura é cancelada ou um pagamento único é reembolsado.

Você pode gerenciar seus webhooks visualizando os registros, excluindo-os ou modificando-os conforme necessário.

4. Visualização dos registros de webhooks:

Para monitorar a atividade do seu webhook ou solucionar problemas relacionados a entregas com falha, você pode acessar facilmente os registros detalhados do webhook.

Para visualizar os registros, clique no menu de três pontos (...) ao lado do webhook que deseja verificar e selecione Visualizar registros (1).

Na página de registros, você encontrará duas seções detalhadas para ajudá-lo a monitorar seus dados:

  • Registro de mensagens (2): Exibe a hora, o tipo de evento e os detalhes da mensagem. Você pode clicar no ícone de detalhes para visualizar mais informações sobre cada mensagem.
  • Registro de entregas (3): Exibe o status da entrega, a hora e se o servidor de destino recebeu o webhook com sucesso.

Dica: Você pode clicar no botão Copiar log, localizado no canto superior direito de qualquer uma das seções, para copiar rapidamente os dados, o que é extremamente útil ao resolver problemas em conjunto com desenvolvedores.

5. Entrega de webhooks e novas tentativas

As entregas de webhooks são processadas em segundo plano. Se o servidor do destinatário estiver temporariamente indisponível, atingir o tempo limite ou retornar um erro, a systeme.io não descartará o webhook imediatamente. Em vez disso, o sistema tentará automaticamente uma nova entrega.

Veja como funciona a política de novas tentativas automáticas:

  • A primeira tentativa de entrega é feita logo após a ocorrência do evento.
  • Se a entrega falhar, o sistema fará até 12 tentativas de reenvio.
  • O intervalo entre as tentativas aumenta gradualmente, com um período máximo de espera de cerca de 24 horas entre cada tentativa. Isso significa que o sistema continuará tentando entregar seu webhook ao longo de vários dias até que seja bem-sucedido.

Ao usar webhooks de maneira eficaz na systeme.io, você pode automatizar processos, aumentar a produtividade e integrar facilmente com outros aplicativos e serviços.