Integrar a Yampi com outras ferramentas web (como, por exemplo, Google Sheets, ContaAzul ou RD Station) via Pluga Webhooks é muito simples. Basta seguir o passo a passo abaixo:
1. Acesse a página de automatizações do Pluga Webhooks e escolha qual será a ferramenta que receberá os dados da sua plataforma Yampi;
2. Após escolher a automatização e clicar em "Fazer essa automatização", nomeie o Pluga Webhooks que será usado para integrar a sua loja. Depois clique em "Gerar Pluga Webhook", conforme mostrado abaixo:
3. Copie a URL que você acabou de gerar;
Agora você precisará configurar o envio de dados pela Yampi. Para fazer isso é muito fácil.
4. Faça login na sua conta da Yampi;
5. No menu lateral, clique em “Configurações” e, em seguida, em “Webhooks”;
6. Agora clique em “+ Novo webhook”, como mostra a imagem abaixo:
7. Nesta tela você deverá inserir o nome do Webhook (ex: Pluga), colar a URL gerada pela Pluga e marcar os eventos. Veja:
8. Clique em "Salvar".
Ótimo! Agora que está tudo ok na Yampi;
9. Volte para a sua automatização na Pluga e clique em "Continuar":
10. Em "Modelo de envio dos dados para notificação" cole um exemplo de JSON da Yampi clique em "Continuar".
Não tem um exemplo de JSON em mãos? Relaxa! Nós separamos um prontinho para você copiar e colar na Pluga. Veja::
{
"event":"order.created",
"time":"2020-09-16 21:55:13",
"merchant":{
"id":4319,
"alias":"exemplo"
},
"resource":{
"id":11495321,
"merchant_id":4319,
"customer_id":18366657,
"status_id":3,
"desire_status_id":[
4,
8,
9
],
"desire_status":[
"paid",
"cancelled",
"refused"
],
"promocode_id":null,
"marketplace_id":null,
"authorized":false,
"sync_by_erp":false,
"has_recomm":false,
"has_upsell":false,
"is_upsell":false,
"delivered":false,
"number":10403,
"marketplace_partner_id":null,
"marketplace_sale_number":null,
"value_total":206.9,
"value_products":187,
"value_shipment":19.9,
"value_tax":0,
"value_discount":0,
"shipment_cost":19.9,
"shipment_service":"Frete com seguro",
"shipment_service_id":"Frete com seguro",
"shipment_icon_url":null,
"shipment_quote_id":"3916062",
"track_code":null,
"track_url":null,
"b2w_label_url":null,
"days_delivery":10,
"date_delivery":{
"date":"2020-09-30 00:00:00.000000",
"timezone_type":3,
"timezone":"America/Sao_Paulo"
},
"cart_token":"61c81d30-e5fc-11ea-b3c3-02f91afe0016-5f43a3704f419",
"utm_source":"taboola",
"utm_campaign":"cp03",
"utm_content":"checkout",
"utm_term":null,
"utm_medium":"feminino",
"total_comments":0,
"payments":[
{
"alias":"billet",
"name":"Boleto Bancário",
"icon_url":"https://somosyampi.github.io/ecommerce-icons/svg/billet.svg"
}
],
"ip":"177.15.85.114",
"device":"mobile",
"reorder_url":"exemplo",
"content_statement_url":"https://api.dooki.com.br/html/orders/content-statement/61c81d30-e5fc-11ea-b3c3-02f91afe0016-5f43a3704f419?id=11495321",
"billet_whatsapp_link":"exemplo",
"public_url":"https://api.dooki.com.br/v2/public/orders/61c81d30-e5fc-11ea-b3c3-02f91afe0016-5f43a3704f419",
"created_at":{
"date":"2020-09-16 21:55:07.000000",
"timezone_type":3,
"timezone":"America/Sao_Paulo"
},
"updated_at":{
"date":"2020-09-16 21:55:08.000000",
"timezone_type":3,
"timezone":"America/Sao_Paulo"
},
"status":{
"data":{
"id":3,
"alias":"waiting_payment",
"name":"Aguardando pagamento",
"description":"Aguardando confirmação de pagamento"
}
},
"marketplace":{
"data":null
},
"customer":{
"data":{
"id":18366657,
"merchant_id":4319,
"marketplace_id":null,
"cluster_id":null,
"active":true,
"type":"f",
"name":"Enzo Leandro Vieira",
"razao_social":null,
"first_name":"Enzo",
"last_name":"Vieira",
"generic_name":"Enzo Leandro Vieira",
"email":"enzoveiraexemplo@gmail.com",
"cnpj":null,
"state_registration":null,
"cpf":"31729400477",
"birthday":null,
"phone":{
"area_code":"96",
"number":"984037675",
"formated_number":"(96) 98403-7675",
"whatsapp_link":"https://api.whatsapp.com/send?phone=5596984037675"
},
"social_driver":null,
"social_id":null,
"newsletter":true,
"whatsapp":false,
"utm_source":"taboola",
"utm_campaign":"cp03",
"ip":"177.15.85.114",
"notes":null,
"token":"f96acf70-f87f-11ea-8cd5-99911a5b6205",
"login_url":"exemplo",
"created_at":{
"date":"2020-09-16 21:51:51.000000",
"timezone_type":3,
"timezone":"America/Sao_Paulo"
},
"updated_at":{
"date":"2020-09-16 21:51:51.000000",
"timezone_type":3,
"timezone":"America/Sao_Paulo"
}
}
},
"discounts":{
"data":null
},
"items":{
"data":[
{
"id":13204183,
"product_id":1493497,
"sku_id":1520200,
"bundle_id":null,
"bundle_name":null,
"price_cost":0,
"price":187,
"item_sku":"1-trio-serum-sou",
"quantity":1,
"shipment_cost":19.9,
"gift":false,
"gift_value":0,
"has_recomm":0,
"customizations":null,
"sku":{
"data":{
"id":1520200,
"product_id":1493497,
"seller_id":null,
"sku":"sku-do-produto",
"erp_id":null,
"blocked_sale":false,
"barcode":null,
"title":"nome-do-produto",
"availability":1,
"availability_soldout":-1,
"days_availability_formated":"1 dia útil",
"price_cost":0,
"price_sale":0,
"price_discount":187,
"width":1,
"height":1,
"length":1,
"weight":0.2,
"quantity_managed":false,
"variations":null,
"combinations":"1520200",
"order":0,
"total_in_stock":0,
"total_orders":null,
"image_reference_sku_id":null,
"purchase_url":"exemplo",
"created_at":{
"date":"2020-03-02 17:09:19.000000",
"timezone_type":3,
"timezone":"America/Sao_Paulo"
},
"updated_at":{
"date":"2020-09-16 21:30:34.000000",
"timezone_type":3,
"timezone":"America/Sao_Paulo"
},
"customizations":{
"data":null
}
}
}
}
]
},
"marketplace_account":{
"data":null
},
"statuses":{
"data":[
{
"id":3,
"alias":"waiting_payment",
"name":"Aguardando pagamento",
"description":"Aguardando confirmação de pagamento",
"details":null,
"created_at":{
"date":"2020-09-16 21:55:08.000000",
"timezone_type":3,
"timezone":"America/Sao_Paulo"
},
"updated_at":{
"date":"2020-09-16 21:55:08.000000",
"timezone_type":3,
"timezone":"America/Sao_Paulo"
}
}
]
},
"shipping_address":{
"data":{
"id":11387395,
"order_id":11495321,
"address_name":null,
"receiver":"Enzo Leandro Vieira",
"zipcode":"68928337",
"zip_code":"68928337",
"street":"Rua Antônio Brilho Rodrigues",
"number":"821",
"complement":"2o andar",
"reference":null,
"neighborhood":"Santo Antônio",
"full_address":"Rua Antônio Brilho Rodrigues, 821 - 2o andar - Santo Antônio",
"city":"Tefé",
"state":"AM",
"uf":"AM"
}
},
"promocode":{
"data":null
},
"transactions":{
"data":[
{
"id":14032401,
"customer_id":18366657,
"payment_id":9,
"affiliation_id":6276,
"marketplace_id":null,
"marketplace_account_id":null,
"authorized":true,
"captured":false,
"cancelled":false,
"gateway_transaction_id":"236901399",
"gateway_order_id":null,
"gateway_authorization_code":null,
"gateway_billet_id":null,
"amount":206.9,
"installments":1,
"installment_value":206.9,
"installment_formated":"1x de R$ 206,90",
"bank_name":null,
"bank_alias":null,
"status":"waiting_payment",
"error_message":null,
"error_code":null,
"truncated_card":null,
"holder_name":null,
"holder_document":null,
"billet_url":"https://api.pagar.me/1/boletos/live_ckf63qvmn58uk0hm5r5lp7tah",
"billet_barcode":"23791.22928 60006.124238 05000.046903 9 83830000020690",
"billet_date":{
"date":"2020-09-19 00:00:00.000000",
"timezone_type":3,
"timezone":"America/Sao_Paulo"
},
"billet_our_number":null,
"billet_document_number":null,
"billet_whatsapp_link":"https://api.whatsapp.com/send?phone=5597984168039&text=Aqui está o boleto do produto *TRIO SERUM SOU*, no valor de R$ 206,90%0a%0aVencimento: *19/09/2020*%0a%0aCódigo de barras: *23791229286000612423805000046903983830000020690*%0a%0aLink: https%3A%2F%2Fapi.pagar.me%2F1%2Fboletos%2Flive_ckf63qvmn58uk0hm5r5lp7tah",
"antifraud_sale_id":null,
"antifraud_status":null,
"antifraud_score":null,
"sent_to_antifraud":false,
"total_logs":0,
"capture_date":null,
"authorized_at":{
"date":"2020-09-16 21:55:07.000000",
"timezone_type":3,
"timezone":"America/Sao_Paulo"
},
"captured_at":null,
"cancelled_at":null,
"created_at":{
"date":"2020-09-16 21:55:07.000000",
"timezone_type":3,
"timezone":"America/Sao_Paulo"
},
"updated_at":{
"date":"2020-09-16 21:55:08.000000",
"timezone_type":3,
"timezone":"America/Sao_Paulo"
},
"payment":{
"data":{
"id":9,
"alias":"billet",
"name":"Boleto Bancário",
"has_config":false,
"active_config":false,
"is_credit_card":false,
"is_deposit":false,
"is_billet":true,
"icon_url":"https://somosyampi.github.io/ecommerce-icons/svg/card-billet.svg"
}
}
}
]
},
"comments":{
"data":null
},
"searchAttributes":{
"data":null
},
"files":{
"data":[
{
"id":6494278,
"context":"billet",
"url":"exemplo"
}
]
},
"seller":{
"data":null
},
"labels":{
"data":null
},
"logs":{
"data":null
},
"cart_links":{
"data":[
{
"name":"Nenhuma",
"icon_url":null,
"url":"exemplo"
},
{
"name":"Pagar.me - Sua loja",
"icon_url":"https://somosyampi.github.io/ecommerce-icons/svg/pagarme.svg",
"url":"url do carrinho"
}
]
},
"merchant":{
"data":{
"id":4319,
"template_id":null,
"active":true,
"is_subdomain":false,
"is_published":true,
"corporate":false,
"is_marketplace":false,
"use_only_checkout":true,
"alias":"exemplo",
"domain":"sualoja.com.br",
"base_url":"https://www.sualoja.com.br",
"name":"Sua Loja",
"icon_url":"exemplo",
"logo_url":"exemplo",
"has_subscription":true,
"has_shopify":true,
"has_services":{
"shopifyapp":true,
"bling":false,
"woocommerce":false,
"tiny":false
},
"shopify_integration":"private_app",
"has_credit_card":true,
"created_at":{
"date":"2020-03-02 16:31:44.000000",
"timezone_type":3,
"timezone":"America/Sao_Paulo"
},
"updated_at":{
"date":"2020-07-14 12:25:27.000000",
"timezone_type":3,
"timezone":"America/Sao_Paulo"
},
"subscription":{
"plan":"Pro",
"status":"active"
}
}
},
"services":{
"data":null
}
}
}
11. Mapeie os campos e personalize as informações que serão enviadas pela Yampi para a sua ferramenta de destino, como mostra o gif abaixo:
12. Prontinho! Agora é só clicar em "Finalizar automatização" e deixar os robôs da Pluga trabalharem para você. 😎
Para mais informações sobre como configurar sua API da Yampi através do Webhook (Postback), você pode acessar a documentação da Yampi.
Dúvidas?
Caso ainda tenha dúvidas, é só solicitar um atendimento que nosso time de suporte entrará em contato dentro de algumas horas ;)