Skip to main content
Skip table of contents

Pluga

O Pluga é uma ferramenta de automação que conecta várias ferramentas. Através dela, é possível enviar as informações da venda do Guru para outra plataforma e disparar uma ação automatizada. Ex.: sempre que uma venda for registrada ou atualizada no Guru, enviar uma mensagem automatizada para um canal do Slack com nome do produto e ID da venda.

A integração entre o Guru e o Pluga ajuda você a:

  • Enviar dados da venda para a plataforma Pluga; e

  • Criar uma automatização com uma ferramenta externa.

A integração do Guru com Pluga é feita através de webhooks. Caso tenha atingido o limite disponível de webhooks, basta realizar um upgrade de plano para a categoria Plus 2 ou Plus 3.

Para ativar a integração manual com o Pluga você deve realizar os 2 passos a seguir.


Nessa página:

  • Passo 1: Obter URL de Retorno

  • Passo 2: Configurar Webhook


Antes de começar você precisa:

  • Ter uma conta ativa no Pluga.

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

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

Passo 1: Obter URL de Retorno

Nesta etapa, você deve acessar a sua conta no Pluga para obter a URL de Postback.

1 - Acesse seu ambiente do Pluga.

2 - Clique em Criar Automatização.

3 - Pesquise por “webhook“ e selecione “Pluga Webhooks

4 - Na lista de opções, selecione o tipo de ação e plataforma que deseja automatizar.

Selecione uma ação que se inicia com “Pluga Webhooks”.

5 - Clique em Fazer essa automatização.

6 - Informe um nome que identifique a automatização que deseja criar - Ex.: Notificação de Venda. Em seguida, clique em Gerar URL de Webhook.

7 - Dependendo da plataforma que escolheu, terá que conectar a sua conta ou informar as chaves API da plataforma de destino.

Consulte a documentação correspondente no pluga para saber como integrar a ferramenta de destino.

8 - Copie e armazene a URL de Webhook.

9 - Clique em Continuar.

10 - Dependendo se vai utilizar um Webhook para Assinaturas ou Vendas Avulsas, copie e armazene um desses códigos modelo:

Assinaturas
JSON
{
    "api_token":"jfTvva9sy1NgCLScX52mZZiT9eDYj869JrOoGmJn",
    "cancel_at_cycle_end":"0",
    "cancel_reason":"",
    "cancelled_by":{
       "name":"",
       "email":"",
       "date":""
    },
    "charged_every_days":3,
    "charged_times":10,
    "current_invoice":{
       "charge_at":"2022-08-10",
       "code":"in_XiEFB5mO28M4OPL0U",
       "created_at":1659864606,
       "cycle":10,
       "discount_value":0,
       "id":"96f6bc06-6231-4cdd-9332-a4821f3d387f",
       "increment_value":0,
       "payment_url":"https:\/\/go.redirect.guru\/pay\/96f6bc06-6231-4cdd-9332-a4821f3d387f\/invoice",
       "period_end":"2022-08-13",
       "period_start":"2022-08-10",
       "status":"paid",
       "subscription_id":"96b432b2-90eb-4759-8e72-f25d86a0b988",
       "tax_value":0,
       "type":"cycle",
       "value":120
    },
    "dates":{
       "canceled_at":null,
       "cycle_end_date":"2022-08-13",
       "cycle_start_date":"2022-08-10",
       "last_status_at":"2022-08-10T10:30:17Z",
       "next_cycle_at":"2022-08-14",
       "started_at":"2022-07-05T07:41:28Z"
    },
    "id":"sub_SO3Vw5NvH3RHQ0Oa",
    "internal_id":"96b432b2-90eb-4759-8e72-f25d86a0b988",
    "last_status":"active",
    "last_transaction":{
       "affiliations":[
          
       ],
       "checkout_url":"",
       "contact":{
          "id":"96b4327a-e939-413e-9e77-fe4aa87e7512",
          "name":"Pedro Sousa",
          "company_name":"",
          "email":"email@example.com",
          "doc":"123456789",
          "phone_number":"912345678",
          "phone_local_code":"55",
          "address":"Rua de exemplo",
          "address_number":"21",
          "address_comp":"",
          "address_district":"",
          "address_city":"Cidade",
          "address_state":"08",
          "address_state_full_name":"Cidade",
          "address_country":"BR",
          "address_zip_code":"123456",
          "lead":[
             
          ]
       },
       "dates":{
          "canceled_at":null,
          "confirmed_at":null,
          "created_at":"2022-08-07T09:30:06Z",
          "expires_at":null,
          "ordered_at":"2022-08-10T03:00:00Z",
          "unavailable_until":null,
          "updated_at":"2022-08-10T10:30:06Z",
          "warranty_until":null
       },
       "ecommerces":[
          
       ],
       "id":"96f6bc06-3060-4a4e-9218-1eb8d132ee71",
       "infrastructure":{
          "ip":"85.242.180.19",
          "city":"cidade",
          "region":"08",
          "country":"PT",
          "user_agent":"Mozilla\/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit\/537.36 (KHTML, like Gecko) Chrome\/103.0.0.0 Safari\/537.36",
          "city_lat_long":"37.136170,-8.537693"
       },
       "invoice":{
          "charge_at":"2022-08-10",
          "created_at":"2022-08-07T09:30:06Z",
          "cycle":10,
          "discount_value":0,
          "id":"in_XiEFB5mO28M4OPL0U",
          "increment_value":0,
          "period_end":"2022-08-13",
          "period_start":"2022-08-10",
          "status":"paid",
          "tax_value":"0.00",
          "tries":1,
          "try":1,
          "type":"cycle",
          "value":120
       },
       "payment":{
          "affiliate_value":0,
          "acquirer":{
             "code":"A",
             "message":"APPROVED",
             "name":"SIMULATOR",
             "tid":"982980"
          },
          "can_try_again":1,
          "coupon":null,
          "currency":"BRL",
          "discount_value":0,
          "gross":120,
          "installments":{
             "value":120,
             "qty":1,
             "interest":0
          },
          "marketplace_id":"tr_MXWvMdLofC5dKo1Mu",
          "marketplace_name":"maxipago",
          "marketplace_value":0,
          "method":"credit_card",
          "net":120,
          "processing_times":{
             "started_at":"2022-08-10T10:30:05.480Z",
             "finished_at":"2022-08-10T10:30:06.367Z",
             "delay_in_seconds":0
          },
          "refund_reason":"",
          "refuse_reason":"",
          "tax":{
             "value":0,
             "rate":0
          },
          "total":120,
          "credit_card":{
             "brand":"visa",
             "expiration_month":"06",
             "expiration_year":"2030",
             "first_digits":"401288",
             "id":"jM64HY1Qv6o=",
             "last_digits":"1881"
          }
       },
       "product":{
          "id":"1657006537",
          "image_url":"",
          "internal_id":"96b43136-ba2f-44d7-a359-cd2a149013a8",
          "marketplace_id":"1657006537",
          "marketplace_name":"maxipago",
          "name":"maxipago - assinatura 1",
          "offer":{
             "id":"96b431a7-a0f4-46af-a839-1ff53cf934b7",
             "name":"maxipago - assinatura 1 - oferta 1"
          },
          "producer":{
             "marketplace_id":"06857631700",
             "name":"Digital Manager Guru",
             "contact_email":""
          },
          "qty":1,
          "total_value":120,
          "type":"plan",
          "unit_value":120
       },
       "shipment":{
          "carrier":"",
          "service":"",
          "tracking":"",
          "value":0,
          "status":"",
          "delivery_time":""
       },
       "shipping":{
          "name":"Standard",
          "value":0
       },
       "source":{
          "source":null,
          "checkout_source":null,
          "utm_source":null,
          "utm_campaign":null,
          "utm_medium":null,
          "utm_content":null,
          "utm_term":null,
          "pptc":[
             
          ]
       },
       "status":"approved",
       "type":"producer"
    },
    "name":"maxipago - assinatura 1",
    "payment_method":"credit_card",
    "product":{
       "id":"96b43136-ba2f-44d7-a359-cd2a149013a8",
       "marketplace_id":"1657006537",
       "marketplace_name":"maxipago",
       "name":"maxipago - assinatura 1"
    },
    "provider":"guru",
    "subscriber":{
       "id":"96b4327a-e939-413e-9e77-fe4aa87e7512",
       "name":"Seu Nome",
       "email":"email@example.com",
       "doc":"123456789",
       "phone_number":"912345678",
       "phone_local_code":"55",
       "address":"Rua de exemplo",
       "address_number":"21",
       "address_comp":"",
       "address_district":"",
       "address_city":"cidade",
       "address_state":"08",
       "address_country":"PT",
       "address_zip_code":"123456"
    },
    "subscription_code":"sub_SO3Vw5NvH3RHQ0Oa",
    "trial_days":0,
    "trial_finished_at":null,
    "trial_started_at":null
 }
Venda Avulsa
JSON
{
    "affiliations":[
       {
          "contact_email":"email@example.com",
          "currency":"BRL",
          "fee":1.4,
          "id":"942d0b62-d416-4c20-b5e8-1edf919c842e",
          "marketplace_id":"JUS6SGEW",
          "name":"Seu Nome",
          "net_value":26.6,
          "value":28
       }
    ],
    "api_token":"jfTvva9sy1NgCLScX52mZZiT9eDYj869JrOoGmJn",
    "checkout_url":"https:\/\/go.redirect.guru\/subscribe\/mais-uma-de-teste2",
    "contact":{
       "id":"96c26d5a-b606-4052-96d2-d965e932b842",
       "name":"Seu Nome",
       "company_name":"",
       "email":"email@example.com",
       "doc":"123456789",
       "phone_number":"912345678",
       "phone_local_code":"55",
       "address":"Rua de Exemplo",
       "address_number":"12",
       "address_comp":"",
       "address_district":"Distrito",
       "address_city":"Cidade",
       "address_state":"RS",
       "address_state_full_name":"RS",
       "address_country":"BR",
       "address_zip_code":"12345678",
       "lead":[
          
       ]
    },
    "dates":{
       "canceled_at":null,
       "confirmed_at":"2022-07-12T09:27:56Z",
       "created_at":"2022-07-12T09:27:04Z",
       "expires_at":null,
       "ordered_at":"2022-07-12T09:26:30Z",
       "unavailable_until":"2022-08-11T09:27:56Z",
       "updated_at":"2022-07-12T09:28:29Z",
       "warranty_until":"2022-08-11T09:27:56Z"
    },
    "ecommerces":[
       
    ],
    "id":"96c26d26-b21e-46b4-a5ab-79d605b2f5f0",
    "infrastructure":{
       "ip":"2001:818:d90a:f200:2da7:42d4:ec8e:8676",
       "city":"lisbon",
       "region":"11",
       "country":"PT",
       "user_agent":"Mozilla\/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit\/537.36 (KHTML, like Gecko) Chrome\/103.0.0.0 Safari\/537.36",
       "city_lat_long":"38.722252,-9.139337"
    },
    "invoice":{
       "charge_at":"2022-07-12",
       "created_at":"2022-07-12T09:27:59Z",
       "cycle":1,
       "discount_value":10,
       "id":"in_dY4GI7QYR9PvwA8k2",
       "increment_value":0,
       "period_end":"2023-07-12",
       "period_start":"2022-07-12",
       "status":"paid",
       "tax_value":"0.00",
       "tries":0,
       "try":0,
       "type":"cycle",
       "value":140
    },
    "last_transaction":[
       
    ],
    "payment":{
       "affiliate_value":26.6,
       "acquirer":{
          "code":"0000",
          "message":"Transa\u00e7\u00e3o aprovada com sucesso",
          "name":"pagarme",
          "tid":17634914
       },
       "can_try_again":1,
       "coupon":null,
       "currency":"BRL",
       "discount_value":0,
       "gross":140,
       "installments":{
          "value":35,
          "qty":4,
          "interest":0
       },
       "marketplace_id":"17634914",
       "marketplace_name":"pagarme",
       "marketplace_value":5.4,
       "method":"credit_card",
       "net":108,
       "processing_times":{
          "started_at":"2022-07-12T09:27:55.959Z",
          "finished_at":"2022-07-12T09:27:56.736Z",
          "delay_in_seconds":0
       },
       "refund_reason":"",
       "refuse_reason":"",
       "tax":{
          "value":0,
          "rate":0
       },
       "total":140,
       "credit_card":{
          "brand":"visa",
          "expiration_month":"12",
          "expiration_year":"2025",
          "first_digits":"411111",
          "id":"card_cl5hz05fv04110u9tz0to6qkv",
          "last_digits":"1111"
       }
    },
    "product":{
       "id":"1622036593",
       "image_url":"",
       "internal_id":"9385fba4-54eb-43ee-9a50-609495f3dc49",
       "marketplace_id":"1622036593",
       "marketplace_name":"pagarme",
       "name":"Assinatura",
       "offer":{
          "id":"96c09b03-a1a2-4f6d-94e9-9746f11e3cd2",
          "name":"mais uma de teste2"
       },
       "producer":{
          "marketplace_id":"09551740742",
          "name":"Produtor",
          "contact_email":"email@example.com"
       },
       "qty":1,
       "total_value":140,
       "type":"plan",
       "unit_value":140
    },
    "shipment":{
       "carrier":"",
       "service":"",
       "tracking":"",
       "value":0,
       "status":"",
       "delivery_time":""
    },
    "shipping":{
       "name":"Standard",
       "value":0
    },
    "source":{
       "source":null,
       "checkout_source":null,
       "utm_source":null,
       "utm_campaign":null,
       "utm_medium":null,
       "utm_content":null,
       "utm_term":null,
       "pptc":[
          
       ]
    },
    "status":"approved",
    "subscription":{
       "can_cancel":1,
       "canceled_at":null,
       "charged_every_days":365,
       "charged_times":1,
       "id":"sub_p9BOf2DsxH1GiLNO",
       "internal_id":"96c26dad-9d2f-494d-a6f0-d2a7967adf51",
       "last_status":"active",
       "last_status_at":"2022-07-12T09:28:09Z",
       "name":"AA Teste Assinatura David",
       "started_at":"2022-07-12T09:27:59Z",
       "subscription_code":"sub_p9BOf2DsxH1GiLNO",
       "trial_days":0,
       "trial_finished_at":null,
       "trial_started_at":null
    },
    "type":"producer"
 }

11 - De volta ao Pluga, informe:

  1. Nome da ferramenta: digite Digital Manager Guru;

  2. Modelo de envio dos dados para notificação: cole o código copiado no passo 10.

12 - Dependendo da ferramenta que vai conectar através do Webhook do Guru, terá que fazer mais algumas configurações, como por exemplo: escolher o canal do Slack, 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 do Pluga ou contate o suporte técnico da ferramenta.

Após completar essa configuração, siga para o passo 2.


Passo 2: Configurar Webhook

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

Ao criar o Webhook, lembre-se de:

  1. Selecionar: Se webhook é de venda, seleciona o status das vendas; e Se o webhook é de assinatura, seleciona o status das assinaturas.

  2. Nome: coloque o nome do seu Webhook;

  3. URL: URL do Webhook, copiada do passo 1 item 4;

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

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

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

(1) Ao escolher filtrar por “todos” ou “marketplaces”qualquer produto novo criado será associado ao webhook automaticamente

Consulte o passo-a-passo completo:

Como Configurar um Webhook

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


Mais Recursos

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.