Webhooks
Webhooks são uma ferramenta para recuperar e armazenar dados de um determinado evento. Eles permitem que você registre uma URL https:// onde os dados do evento podem ser armazenados nos formatos JSON ou XML. Webhooks são normalmente usados para:
- Fazer um pedido
- Alterar o preço de um produto
- Notificar seu cliente de mensagens instantâneas ou seu pager quando você estiver off-line
- Coletar dados para armazenamento
- Integrar seu programa de contabilidade
- Filtrar os itens do pedido e informar várias transportadoras sobre o pedido
- Remover dados do cliente do seu banco de dados quando eles desinstalarem seu app
Criar webhooks
Passos:
- No admin da Shopify, acesse Configurações > Notificações.
- No app da Shopify, acesse Loja > Configurações.
- Em Configurações da loja, toque em Notificações.
- No app da Shopify, acesse Loja > Configurações.
- Em Configurações da loja, toque em Notificações.
Role para baixo até a seção Webhooks.
Clique no botão Criar webhook. Uma nova janela deve aparecer.
Na primeira lista suspensa, selecione "Evento" na lista a seguir:
- Criação de carrinho: um webhook será enviado toda vez que um carrinho for criado. - Atualização do carrinho: um webhook será enviado toda vez que um carrinho for atualizado. - Criação de checkout: um webhook será enviado toda vez que um checkout for criado. - Exclusão do checkout: um webhook será enviado toda vez que um checkout for excluído. - Atualização do checkout: um webhook será enviado toda vez que um checkout for atualizado. - Criação de coleções: um webhook será enviado toda vez que uma coleção for criada. - Exclusão de coleção: um webhook será enviado toda vez que uma coleção for excluída. - Atualização de coleção: um webhook será enviado toda vez que uma coleção for atualizada. - Criação de grupo de clientes: um webhook será enviado toda vez que um grupo de clientes for criado. - Exclusão do grupo de clientes: um webhook será enviado toda vez que um grupo de clientes for excluído. - Atualização do grupo de clientes: um webhook será enviado toda vez que um grupo de clientes for atualizado. - Criação de cliente: um webhook será enviado toda vez que um novo cliente for criado. - Exclusão de cliente: um webhook será enviado toda vez que um registro do cliente for excluído. - Desabilitação de cliente: um webhook será enviado toda vez que uma conta de cliente for desabilitada. - Habilitação de cliente: um webhook será enviado toda vez que uma conta de cliente for habilitada. - Atualização de cliente: um webhook será enviado toda vez que um registro do cliente for atualizado. - Criação de rascunho de pedido: um webhook será enviado toda vez que um rascunho de pedido for criado. - Exclusão de rascunho de pedido: um webhook será enviado toda vez que um rascunho de pedido for criado. - Atualização do rascunho de pedido: um webhook será enviado toda vez que um rascunho de pedido for atualizado. - Criação de processamento: um webhook será enviado toda vez que um processamento for criado em um pedido. - Atualização de processamento: um webhook será enviado toda vez que o processamento for atualizado em um pedido. - Cancelamento de pedido: um webhook será enviado toda vez que um pedido for cancelado. - Criação de pedido: um webhook será enviado toda vez que um pedido for criado. - Exclusão de pedido: um webhook será enviado toda vez que um pedido for excluído. - Processamento de pedido: um webhook será enviado toda vez que um pedido for processado. - Pagamento do pedido: um webhook será enviado toda vez que um pedido for pago. - Atualização do pedido: um webhook será enviado toda vez que um pedido for atualizado. - Criação de produto: um webhook será enviado toda vez que um produto for criado. - Exclusão do produto: um webhook será enviado toda vez que um produto for excluído. - Atualização do produto: um webhook será enviado toda vez que um produto for atualizado. - Criação de reembolso: um webhook será enviado toda vez que um reembolso for emitido. - Atualização da loja: um webhook será enviado toda vez que uma propriedade da lojafor atualizada. - Criação de tema: um webhook será enviado toda vez que um tema for criado. - Exclusão de tema: um webhook será enviado toda vez que um tema for excluído. - Atualização de tema: um webhook será enviado toda vez que uma propriedade de tema for atualizada.
Na segunda lista suspensa, escolha o formato em que você gostaria que a Shopify enviasse essas informações para você. As duas opções são JSON ou XML.
Em URL, insira a URL na qual você gostaria que os dados fossem armazenados. É importante observar que os webhooks não podem ser retornados para as seguintes URLs:
- Localhost - Qualquer URL que termine com a palavra "internal" (ou seja, thisshop.com/internal) - Domínios "falsos", como www.example.com - Domínios da Shopify (ou seja, shopify.com e myshopify.com)
Clique em Adicionar webhook. Seu webhook deve aparecer agora na seção "Webhooks".
Você também pode testar seu webhook para garantir que as informações desejadas sejam enviadas para a URL correta. Para fazer isso, clique no link enviar notificação de teste. Verifique na URL que você especificou se isso funciona.
Excluir webhooks
Passos:
- No admin da Shopify, acesse Configurações > Notificações.
- No app da Shopify, acesse Loja > Configurações.
- Em Configurações da loja, toque em Notificações.
- No app da Shopify, acesse Loja > Configurações.
- Em Configurações da loja, toque em Notificações.
Role para baixo até a seção Webhooks.
Ao lado do webhook que você criou, deve haver um ícone de lixeira.
Clique no ícone da lixeira para excluir o webhook.