# Webhooks Integrados - Shopify para o Sprinthub

## Adicionando Evento de Webhook no Shopify

Para criar um novo Webhook no painel do Shopify, siga os passos abaixo:

1. Acesse **Definições > Notificações**.
2. Clique na seção **Webhooks** e clique em **Criar Webhook**.
3. Na tela de criação, selecione o **evento** que será responsável por disparar os dados para a SprintHub.
4. Informe a **URL do Webhook Passivo**, que será responsável por lidar com esses dados. Como, por exemplo, a criação de um lead ou a execução de ações adicionais em um lead já existente na instância.

Neste exemplo, utilizaremos o evento **Criação de Cliente**.

<figure><img src="/files/H4yBY0N0XtczVDCBCcVY" alt=""><figcaption><p><em>Notificações Shopify.</em></p></figcaption></figure>

<figure><img src="/files/eB792nkfhByF2dKJQdB0" alt=""><figcaption><p><em>Webhooks Shopify</em>.</p></figcaption></figure>

<figure><img src="/files/XplO9w6AUk58JCjR5cdR" alt=""><figcaption><p><em>Modal Adicionar Webhook.</em></p></figcaption></figure>

## Fazendo Mapeamento Automático do Evento

Para realizar o mapeamento automático:

1. No Webhook Passivo da SprintHub, clique em **Mapeamento Automático**.
2. Em seguida, acesse o Shopify e clique em **Enviar Teste** dentro da configuração do Webhook.\
   Isso enviará um disparo de teste para a SprintHub, permitindo que a plataforma identifique e mapeie os campos automaticamente.

<figure><img src="/files/GLP7X3PRTN13kFzxbQVa" alt=""><figcaption><p><em>Webhook da Sprinthub.</em></p></figcaption></figure>

<figure><img src="/files/mBNsTkjmG9gdk5xsT7ql" alt=""><figcaption><p><em>Botão Enviar Teste.</em></p></figcaption></figure>

## Configurações do Webhook

O campo **"Identificador para"** define qual chave do JSON será usada como identificador único do lead — por exemplo, o número de WhatsApp — assim que os dados chegarem no Webhook Passivo da SprintHub.\
Se um lead com esse identificador já existir na base, ele **não será recriado**; apenas as **ações extras configuradas** serão executadas.

<figure><img src="/files/Hqu7RcWnBGTl9VpDRuhH" alt=""><figcaption><p><em>Identificador para.</em></p></figcaption></figure>

<figure><img src="/files/uvIHxfPFUICJa76o8VHL" alt=""><figcaption><p><em>Criação Automática de Leads.</em></p></figcaption></figure>

## Verificando o Registro do Webhook

Dentro do Webhook, é possível visualizar o **registro de logs**, incluindo informações como leads criados, identificados, e demais detalhes relevantes.\
É importante destacar que todos os dados enviados pelo Shopify estarão presentes no **corpo da requisição** (chave `body`).\
Ali, é possível analisar cada campo enviado no evento — como **CEP do cliente**, **nome completo**, **e-mail**, entre outros — facilitando o entendimento e o mapeamento dos dados.

<figure><img src="/files/udgJ643WXpwdJqhb1ujM" alt=""><figcaption><p><em>Registro 'Webhook Recebido'.</em></p></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.sprinthub.com/topicos/analisar/webhooks-integrados/webhooks-integrados-duvidas-comuns/webhooks-integrados-shopify-para-o-sprinthub.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.