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:
{
"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
}{
"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:
Nome da ferramenta: digite Digital Manager Guru;
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:
Selecionar a categoria “Venda” ou “Assinatura” de acordo com o tipo de notificação que deseja enviar; e
Se for webhook de venda:
Selecionar todos os status de venda desejados; e
Marcar filtrar por
MarketplacesouProdutos; eMarcar a opção Selecionar Todos (ou apenas os itens desejados).
Consulte o passo-a-passo completo:
Pronto! A partir deste momento, cada venda ou assinatura atualizada que atender aos critérios definidos no webhook configurado será enviada para o Pluga.