> For the complete documentation index, see [llms.txt](https://docs.sprinthub.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sprinthub.com/topicos/analisar/webhooks-integrados/webhooks-integrados-duvidas-comuns/webhooks-integrados-shopify-para-o-sprinthub.md).

# 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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.