Como integrar a sua plataforma Yampi a outras ferramentas web via Pluga Webhooks

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:

yampi-0.gif

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”;

yampi-01.png

6. Agora clique em “+ Novo webhook”, como mostra a imagem abaixo:

yampi-02.png

7. Nesta tela você deverá inserir o nome do Webhook (ex: Pluga), colar a URL gerada pela Pluga e marcar os eventos. Veja:

yampi-03.png

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":

botao-continuar.png

10. Em "Modelo de envio dos dados para notificação" cole um exemplo de JSON da Yampi clique em "Continuar".

yampi-4.gif

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:

yampi-6.gif

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 ;)

Esse artigo foi útil?
Usuários que acharam isso útil: 0 de 0