Integrações

Pluga via Webhook: eventos além da integração nativa:

Além da integração nativa com a Pluga, você também pode conectar a Guru à Pluga por webhook. O webhook é um aviso automático enviado para uma URL sempre que um evento acontece. Com os Webhooks e o HTTP Request da Pluga, você leva para outras ferramentas eventos que vão além dos três gatilhos da integração nativa, sem programação.

Assim, você pode avisar o time no Slack quando uma assinatura for cancelada ou registrar cada ingresso vendido em uma planilha de participantes.


Nessa página:

  • Passo 1: Obter URL de Retorno na Pluga

  • Passo 2: Configurar Webhook

  • Passo 3: Testar Webhook na Guru e Configurar automatização na Pluga


Antes de começar, você precisa:

  • Ter uma conta ativa na Pluga.

  • Possuir limite de webhook disponível para uso em sua conta Guru.

  • Ser usuário administrador na Guru ou ter permissões para executar os passos a seguir.

Passo 1: Obter URL de Retorno na Pluga

Nesta etapa, você deve acessar a sua conta na Pluga gerar a URL de Webhook necessária para realizar a integração entre a Guru e a Pluga.

Etapas:

1 - Acesse seu ambiente da Pluga com seu usuário e senha.

2 - Clique em Criar.

criar-automacao-pluga.png

3 - Em seguida, clique em Nova Automatização.

clique-nova-automatizacao-pluga.png

4 - Caso queira, você pode clicar para renomear o Nome da automatização.

renomear-automatizacao-pluga.png

5 - Em seguida, selecione a ferramenta e como ela irá iniciar sua automatização.

  1. Ferramenta: pesquise por Webhooks;

  2. Gatilho: selecione a opção notificação recebida.

selecionar-ferramenta-automatizacao.png

6 - Salvar e Continuar.

7 - Em Configure sua conta do Webhooks, copie e armazene a URL de Webhook.

copiar-url-webhook-pluga.png

Nota: Se necessário, você pode clicar em Gerar nova URL para criar uma nova URL de webhook. Caso faça isso, certifique-se de substituir o link antigo dentro das configurações da Guru.

8 - Salvar e Continuar.

Ao clicar em Salvar e continuar, a Pluga abrirá a tela onde ficará escutando a URL. Nesse momento, você deverá configurar o webhook na Guru (conforme passo 2), realizar a venda de teste e aguardar alguns instantes até que o modelo de dados (JSON) seja carregado automaticamente.


Passo 2: Configurar Webhook

Neste passo, você deve acessar sua conta na Guru (Configurações » Webhooks) e configurar um webhook de e-ticket, de venda ou de assinatura para enviar as notificações para a Pluga.

Ao criar o Webhook, lembre-se de:

  1. Selecionar: se o webhook é de assinatura, selecione o status das assinaturas; se o webhook é de e-tickets, selecione o status dos e-tickets; se o webhook é de vendas, selecione o status das vendas;

  2. Nome: coloque o nome do seu Webhook;

  3. URL: URL do Webhook, obtido do passo 1 - item 7;

  4. Envios simultâneos: selecione os envios simultâneos;

  5. Status: selecione todos os status de venda; status das assinaturas ou status dos e-tickets desejados;

  6. Filtrar por: marcar filtrar por todos, Marketplaces ou Produtos(1);

  7. Mude o botão Ativo para a posição ligado.

(1) Ao escolher filtrar por “todos” ou “marketplaces”qualquer produto novo criado será associado ao webhook automaticamente.
image-20260820-165219.png
desligado - ligado.png

Consulte o passo a passo completo:

Como configurar um webhook de assinaturas, e-tickets ou vendas.

Pronto! A partir deste momento, cada venda ou assinatura atualizada que atender aos critérios definidos no webhook configurado será enviada para a Pluga.


Passo 3: Testar Webhook na Guru e Configurar automatização na Pluga

Nesta etapa, você irá validar a integração entre a Pluga e a Guru. Para isso, após criar o webhook na Guru (passo 2), será necessário realizar uma venda de teste na Guru. Esse disparo enviará os dados necessários para que a Pluga identifique o evento e mapeie o modelo de dados para a automação.

Etapas:

1 - Acesse o admin da Guru com seu usuário e senha.

2 - Faça uma venda de teste na Guru após a criação do webhook.

3 - Retorne ao seu ambiente da Pluga com seu usuário e senha.

4 - Em Ajuste as opções do Webhooks aguarde a Pluga “Escutar a URL do Webhooks para gerar o modelo de dados”.

gere-um-evento-ferramenta-pluga.png

Para que o modelo de dados (JSON) seja gerado automaticamente, a Pluga precisa "escutar" a URL do Webhook logo após a realização da venda de teste na Guru. O carregamento leva apenas alguns segundos, portanto, aguarde a atualização da tela para prosseguir com a configuração da automação.

5 - Em seguida, assim que a Pluga recebe o evento, o modelo de JSON é preenchido automaticamente.

validar-json-pluga.png

6 - Clique em Salvar e Continuar.

7 - Em seguida, em Ferramenta e Ação selecione:

  1. Ferramenta: a ferramenta Webhooks;

  2. Ação: a ação que será executada.

selecione-ferramenta-acao-pluga.png

8 - Clique em Salvar e Continuar.

9 - Em seguida, em Ajuste as opções do Webhooks informe:

  1. Nome da ferramenta (obrigatório): digite Digital Manager Guru;

  2. Método de requisição (opcional): o método de requisição que será utilizado;

  3. Modelo de retorno dos dados (opcional): o modelo de dados (no formato JSON) que irá retornar para a pluga.

ajustar-opcoes-webhooks-pluga.png

10 - Clique em Salvar e Continuar.

11 - Em Personalize as informações para que fique a sua cara, selecione o mapeamento dos campos:

  1. URL da API da ferramenta (obrigatório): o endereço de API que a pluga irá enviar as informações desejadas;

  2. Campo da ferramenta (opcional): o nome e as informações da ferramenta de origem que serão enviadas pelo Pluga Wehooks;

  3. Cabeçalhos (opcional): a chave e o valor a ser enviado como informações dos cabeçalhos da requisição;

  4. Parâmetros de busca da requisição (opcional): a chave e o valor a ser enviado como informações dos parâmetros de busca da requisição.

personalizar-webhooks-pluga.png

12 - Clique Salvar e Continuar.

13 - Em seguida, clique em Finalizar Automatização.

finalizar-automatizacao-pluga.png

14 - Após clicar em Finalizar Automatização uma caixa de texto aparecerá com a confirmação da automatização.

caixa-de-texto-finalizacao-automatizacao.png

Dependendo da ferramenta que vai conectar através do Webhook da Guru, você terá que fazer mais algumas configurações, como, por exemplo, escolher o canal do Slack, a mensagem a ser enviada ou escolher a lista e os campos do contato que vai enviar para o seu CRM. Se tiver alguma dúvida nesses passos, visite a Central de Ajuda da Pluga ou contate o suporte técnico da ferramenta.


Mais Recursos