Envie mensagens de pedido da Shopify pelo WhatsApp

Como o Shopify Flow envia uma mensagem no WhatsApp?

Com a ação Enviar requisição HTTP, que faz um POST para qualquer URL, com cabeçalhos e um corpo que podem usar variáveis Liquid do gatilho.

Crie um fluxo com o gatilho de criação de pedido e adicione Enviar requisição HTTP. A URL é o endpoint de mensagens da Cloud API para o phone_number_id do número conectado. Adicione um cabeçalho Authorization cujo valor é Bearer seguido do token de acesso do número, guardado como segredo do Flow e referenciado como variável secreta. Os valores secretos nunca aparecem na interface do Flow e são ocultados nos logs de execução, que é o lugar certo para um token. O corpo é uma mensagem de template, com o telefone do cliente no campo to e os dados do pedido como parâmetros do template.

O Flow considera uma resposta 2XX ou 3XX como sucesso. A Meta responde a uma requisição válida com o id da mensagem, então uma execução bem-sucedida significa que a Meta aceitou a mensagem.

{
  "messaging_product": "whatsapp",
  "to": "<customer phone, digits only>",
  "type": "template",
  "template": {
    "name": "order_confirmation",
    "language": { "code": "en" },
    "components": [{
      "type": "body",
      "parameters": [{ "type": "text", "text": "{{order.name}}" }]
    }]
  }
}

Por que a mensagem de pedido precisa ser um template?

Porque a loja é quem escreve primeiro. A janela de atendimento de 24 horas da Meta só abre quando o cliente escreve para o número. Uma confirmação de pedido, uma atualização de envio ou um lembrete de carrinho abandonado saem antes disso, então texto livre é recusado e só passa um template pré-aprovado.

Crie o template uma vez, na categoria utility para atualizações de pedido e envio, e espere a aprovação antes de ligar o fluxo. O nome e o idioma no corpo da requisição precisam ser idênticos aos do template aprovado, e o número de parâmetros precisa corresponder aos placeholders.

Há também o consentimento. A Meta exige opt-in antes de uma empresa enviar mensagem a alguém no WhatsApp: a pessoa informou o número e concordou em receber mensagens dessa empresa. Uma caixa de seleção no checkout que diga isso é a forma usual de coletar, e o fluxo deve verificá-la antes de enviar.

E se o plano da loja não incluir Enviar requisição HTTP?

Use um webhook do admin da Shopify. Em Configurações, Notificações, Webhooks, o lojista pode criar um webhook para um evento como a criação de pedido, em JSON, para uma URL. Aponte-o para um receptor: um nó Webhook do n8n ou uma rota em PHP, Python ou Node. O receptor lê o pedido, verifica o consentimento e faz a mesma chamada de template à Cloud API.

Por qualquer caminho que envie, as respostas funcionam igual. Quando o cliente responde à mensagem do pedido, a resposta chega no app do WhatsApp Business no celular da loja, porque o número está em Coexistência, e a janela de atendimento de 24 horas passa a estar aberta para texto livre. Se o destino do webhook do número estiver configurado, a resposta também chega ao seu sistema. A própria mensagem do pedido também aparece no app, então quem responde vê a que o cliente está respondendo.

Erros comuns

• Enviar texto livre na criação do pedido. O cliente ainda não escreveu, então a Meta recusa; precisa ser um template aprovado.
• Deixar o tratamento de erros em Repetir para respostas 4XX. O Flow pode repetir por até 24 horas uma requisição que a Meta nunca vai aceitar.
• Colocar o token em um cabeçalho como texto simples. Guarde-o como segredo do Flow para que fique fora da interface e dos logs.

Perguntas frequentes

Continue lendo