Como ligar o Zendesk aoShopify Flow

O Zendesk pode acionar um Webhook a partir de um gatilho ou de uma automação sempre que um ticket sofrer alterações. O Workflow Webhooks transforma essa chamada num gatilho do Shopify Flow, para que a sua loja possa reagir a ela: atribuir uma etiqueta a um cliente, adicionar uma nota ao pedido, enviar um e-mail interno, atualizar um metacampo - tudo o que o Shopify Flow permite fazer.

Este guia define todo o percurso - o Zendesk envia, o Workflow Webhooks recebe e verifica, o Shopify Flow executa - com a assinatura HMAC do Zendesk verificada em cada pedido, pelo que apenas o Zendesk pode iniciar o seu fluxo de trabalho.

O que pode construir

• Tag o cliente Shopify associado a um ticket que foi encaminhado para um nível superior, para que a sua equipa o veja na área de administração.
• Adicione uma nota ao pedido quando um pedido de suporte relacionado com esse pedido for resolvido.
• Envie um e-mail a um responsável sempre que um cliente de elevado valor atribuir uma classificação de satisfação negativa.

Eventos típicos a enviar: é criado um ticket, um ticket é resolvido, é recebida uma avaliação de satisfação.

Antes de começar

• Workflow Webhooks instalado na sua loja Shopify.
• Shopify Flow instalada, que está disponível gratuitamente na App Store da Shopify.
• Uma conta no Zendesk com permissão para criar webhooks.

Passo 1 - Crie o webhook em Workflow Webhooks

1. Aceda a Workflow Webhooks -> Webhooks -> Criar webhook e atribua-lhe um nome que consiga reconhecer no Shopify Flow, como, por exemplo, Zendesk events.
2. Na secção «Autenticação», selecione HMAC.
3. Na secção «Fornecedor de assinatura», selecione «Zendesk». A aplicação preenche automaticamente o cabeçalho, o algoritmo, o payload assinado e a janela de repetição - não é necessário configurar mais nada.
4. Por enquanto, deixe o campo «Segredo» em branco e clique em «Guardar». Copie o URL do webhook apresentado na página.

Consulte Autenticação para conhecer os outros modos de autenticação e Mapeamento da carga útil e variáveis de fluxo para saber quais os campos que são transmitidos ao Shopify Flow.

Passo 2 - Adicione o ponto de extremidade no Zendesk

No Centro de Administração do Zendesk, abra «Aplicações e integrações» → «Webhooks», crie um webhook que aponte para o URL que copiou, associe-o a um gatilho e, em seguida, utilize a opção «Revelar segredo».

Como encontrar o seu segredo de assinatura do Zendesk

O segredo de assinatura do webhook (Centro de Administração → Aplicações e integrações → Webhooks → Revelar segredo).

A própria documentação da Zendesk sobre assinaturas de webhooks contém o texto exato e as capturas de ecrã relativas à sua conta.

Cole esse segredo no campo «Secret» do webhook em Workflow Webhooks e guarde. A partir desse momento, todas as mensagens enviadas pelo Zendesk serão verificadas antes de chegarem ao Shopify Flow.

O que isto verifica

O quê	Valor
Cabeçalho da assinatura	X-Zendesk-Webhook-Signature
Onde se encontra a assinatura	O valor completo do cabeçalho
O que foi assinado	{header:x-zendesk-webhook-signature-timestamp}{body}
Assinatura	HMAC-SHA256, codificado em base64
Data e hora	Não é utilizado por este remetente
Proteção contra reprodução	Nenhuma - este remetente não assina o carimbo temporal, pelo que todas as assinaturas válidas permanecem válidas
O segredo	Utilizado como texto simples. Cole-o exatamente tal como o remetente o apresenta

Na carga útil assinada, {body} corresponde ao corpo da solicitação em formato bruto, byte a byte, e {header:x-zendesk-webhook-signature-timestamp} corresponde ao cabeçalho da solicitação x-zendesk-webhook-signature-timestamp.

Um pedido que não cumpra qualquer um destes requisitos é rejeitado com o código de erro 401, é registado em Histórico e resolução de problemas e nunca dá início a um fluxo de trabalho.

Passo 3 - Criar o fluxo de trabalho Shopify Flow

1. No «Shopify Flow», crie um fluxo de trabalho e selecione o gatilho «Workflow Webhooks».
2. Clique em «Registar eventos» e, em seguida, envie um evento de teste a partir do Zendesk (ou utilize a opção «Enviar teste» em Workflow Webhooks) para que o Shopify Flow aprenda a estrutura dos seus dados.
3. Cada webhook de que dispõe aciona o mesmo gatilho do Flow; por isso, adicione uma primeira condição com base no ID do webhook para que este fluxo de trabalho se limite apenas ao Zendesk. O ID é apresentado na página do webhook.
4. Adicione as suas ações - identifique um cliente, adicione uma nota, envie um e-mail interno, atualize um metacampo.

Passo 4 - Teste-o de ponta a ponta

Gatilho para um evento real no Zendesk. Em Workflow Webhooks -> Histórico, deverá ver a invocação com o estado «Sucesso». Se a assinatura estiver incorreta, receberá, em vez disso, um registo de falha com o motivo correspondente; em Verificação de webhooks assinados, encontra explicações sobre o verificador de assinaturas, que lhe mostra exatamente em que etapa ocorreu a falha.

Relacionado

• Verificação de webhooks assinados - todos os prestadores de serviços que verificamos e como descrever aqueles que não verificamos.
• Mapeamento da carga útil e variáveis de fluxo - extrair os campos corretos do payload e transferi-los para o Shopify Flow.
• Proteção contra entregas duplicadas - o que acontece quando o Zendesk tenta novamente a entrega.
• Histórico e resolução de problemas - o registo de cada pedido, com reprodução.