Quando algo acontece na sua loja, a Shopify envia uma mensagem sobre isso ao seu MemberArea. Cada uma dessas mensagens é uma entrega, e cada entrega é registrada com o resultado, tenha funcionado ou não. O registro de webhooks é onde você olha quando um comprador diz que o curso dele está faltando, ou quando quer saber o que um reembolso ou uma alteração de produto realmente fez.
Abrir o registro
Abra a sua página da Shopify em /admin/settings/integrations/shopify, ou abra
Configurações, depois Integrações, depois Adicionar integração e
Shopify. Em seguida escolha a aba Registro de webhooks. O registro
continua legível enquanto a loja está desconectada, então você ainda pode ver o
que chegou antes.
Até chegar a primeira entrega, a aba diz "Ainda não foram recebidos webhooks. Faça um pedido de teste na sua loja para verificar a conexão." Um pedido de teste é a forma mais rápida de ver a primeira linha.
O que uma linha mostra
A lista não tem cabeçalhos de coluna. Cada entrega é uma linha:
| Onde | O que mostra |
|---|---|
| Linha de cima | O tópico, que indica o que aconteceu na loja. |
| Linha abaixo | Uma nota curta sobre o que o seu MemberArea fez com a entrega. Se ela falhou, o erro aparece ali no lugar. |
| Abaixo da nota | A data e a hora em que a entrega foi recebida. |
| Selo à direita | O resultado: Processado, Ignorado, Ainda não processado, Tentando novamente ou Falhou. |
| Botão ao lado | Processar de novo, só nas linhas que podem ser executadas de novo. |
Clique em uma linha para abrir os detalhes. Eles listam o que a entrega trouxe entre Número do pedido, Endereço de e-mail, Total, Moeda e ID do Shopify, sempre o número de Tentativas, e o erro completo, se houve um. Clique na linha de novo para fechá-la.
Os tópicos que você vai ver são orders/paid, orders/cancelled,
refunds/create, customers/create, customers/update, customers/delete,
products/update, products/delete e app/uninstalled. Os três tópicos de
privacidade da Shopify customers/data_request, customers/redact e
shop/redact também chegam aqui.
Os cinco resultados
Processado significa que o seu MemberArea fez o trabalho. Para um pedido pago, a nota diz algo como "Order SHP-1042 imported, 1 mapped item(s)." e o comprador tem o acesso associado. Um pedido pago de um produto que ninguém associou também é processado: a nota diz "Order SHP-1042 imported, no mapped item." O pedido existe, conta na sua receita, e o comprador se torna um membro sem nenhum acesso. Isso também vale para produtos físicos que você vende junto com os seus cursos.
Ignorado significa que a entrega foi entendida e não havia nada a fazer. A nota diz o motivo, por exemplo "This product is not mapped." para uma alteração de produto para a qual nenhuma associação aponta, ou "This update is the echo of our own push." depois que você mesmo enviou um produto para a Shopify.
Ainda não processado significa que a entrega chegou e está esperando a vez. Uma linha não deveria ficar assim por mais de alguns segundos. Se muitas linhas ficam em Ainda não processado, algo travou do nosso lado. Escreva para support@memberarea.io.
Tentando novamente significa que a entrega deu errado e está prestes a ser tentada de novo sozinha. A linha da nota traz o erro da última tentativa.
Falhou significa que algo deu errado e as tentativas automáticas se esgotaram. A linha da nota traz o erro, e a linha oferece Processar de novo.
Entregas que falharam são tentadas de novo sozinhas
Uma entrega que falha é tentada de novo automaticamente algumas vezes, com uma pausa entre as tentativas. Enquanto essas tentativas ainda estão em andamento, a linha mostra Tentando novamente, e Tentativas nos detalhes aumenta a cada tentativa. Só quando a última tentativa falha a linha passa para Falhou. Uma linha em Falhou precisa de você: corrija a causa e execute de novo. O registro de webhooks no app dentro do seu painel da Shopify mostra os mesmos estados, "Retrying" até as tentativas se esgotarem e "Failed" depois disso.
Executar uma entrega de novo
Clique em Processar de novo na linha. O botão só aparece para uma entrega que falhou, está sendo tentada de novo ou ainda não foi processada. Uma linha que conta como processada ou ignorada não tem o botão. A linha volta para Ainda não processado e depois é trabalhada com os dados que a Shopify enviou originalmente, então executá-la de novo depois de corrigir a causa faz o trabalho completo, não uma versão reduzida dele.
Nada é executado duas vezes. Se a Shopify envia a mesma entrega de novo, ela não ganha uma segunda linha. Um pedido pago que chega duas vezes continua virando um único pedido e libera o acesso uma vez, e um reembolso que chega duas vezes é lançado uma vez. Clicar em Processar de novo nunca duplica um pedido, um acesso ou um reembolso.
Filtrar e paginar o registro
Os botões acima da lista a restringem a Processado, Ignorado ou Falhou, e Todos traz tudo de volta. Falhou lista só as entregas cujas tentativas automáticas se esgotaram. Linhas em Ainda não processado e Tentando novamente só aparecem em Todos. Atualizar recarrega a página em que você está, então você pode ver uma nova entrega chegar.
Cabem vinte e cinco entregas por página, das mais novas para as mais antigas. As entregas mais antigas ficam nas páginas seguintes, que você acessa abaixo da lista.
Quando um cliente relata um curso faltando, filtre primeiro por Falhou,
depois por Ignorado, e então veja a linha orders/paid dele em
Processado. Entre esses três você quase sempre encontra a resposta.
Notas que você realmente vai ver
| Nota | O que significa e o que fazer |
|---|---|
| "Order SHP-1042 imported, no mapped item." | O pedido está aqui, mas o produto dele não libera nada. Associe o produto para que os próximos compradores recebam acesso, veja Vincular um produto da Shopify a um curso. |
| "This product is not mapped." | Mudou na loja um produto para o qual nenhuma associação aponta. Nada a fazer, a menos que você quisesse associá-lo. |
| "This update is the echo of our own push." | A Shopify devolveu uma alteração que o seu MemberArea fez. Nada a fazer. |
| "This delivery carried no order id or the order was already imported." | Ou a entrega não tinha ID de pedido, ou o pedido já está aqui. Nada a fazer. |
| "Refund recorded, the refunded items were not mapped." | O reembolso foi lançado, mas era de produtos que nunca foram associados, então não havia acesso para retirar. |
| "The order for this refund has not been imported yet, trying again shortly." | O reembolso chegou antes do pedido. Ele é tentado de novo sozinho, e a linha mostra Tentando novamente enquanto isso. Se terminar em Falhou, clique em Processar de novo quando a linha do pedido mostrar Processado. |
O que reembolsos e cancelamentos fazem com o acesso, o pedido e as comissões está em Reembolsos e cancelamentos na Shopify.
Só entregas reais da Shopify
Toda entrega precisa trazer uma assinatura válida da Shopify. Uma mensagem sem ela é recusada e nunca aparece no registro. Uma entrega que a Shopify disparou há mais de sete dias também não é aceita. Se uma linha que você espera não aparece de jeito nenhum, confira se a loja está conectada, veja Conectar sua loja Shopify.
Pedidos de privacidade da Shopify
A Shopify repassa pedidos de privacidade dos clientes da sua loja, e cada um aparece como uma linha.
Quando um cliente pede à Shopify que exclua os dados dele, chega uma entrega
customers/redact. O seu MemberArea remove o vínculo com esse cliente da
Shopify e as entregas armazenadas sobre ele. O membro, o contato e os pedidos
dele permanecem: eles pertencem ao seu espaço de trabalho, e o cliente também
pode ter comprado de você em outro lugar. A nota diz algo como "Removed 1 link
and 4 stored deliveries for Shopify customer 7012345678. The member itself
belongs to the workspace and stays." Se você também quer que a pessoa saia do
seu MemberArea, exclua o membro ou o contato você mesmo.
Quando um cliente pede os dados dele, chega uma entrega
customers/data_request e os proprietários do seu espaço de trabalho recebem
um e-mail e uma notificação com o título "Um cliente do Shopify solicitou seus
dados". A Shopify espera a sua resposta em até 30 dias, e o seu MemberArea não
envia os dados por você. O que mais acontece em torno de privacidade e
desinstalação está em
Desconectar a Shopify e excluir os dados da loja.
O que é guardado
Cada entrega é armazenada com os dados que a Shopify enviou, para que executá-la de novo faça o trabalho completo. Esses dados são sobre os seus clientes, por isso são armazenados criptografados. As entregas são excluídas 90 dias depois de chegarem.