Enviar mensagens de encomendas do Shopify por WhatsApp

Como envia o Shopify Flow uma mensagem de WhatsApp?

Com a ação Send HTTP request, que envia um pedido para qualquer URL, com cabeçalhos e um corpo que pode usar variáveis Liquid do acionador.

Crie um fluxo de trabalho com o acionador de criação de encomenda e adicione Send HTTP request. O URL é o endpoint de mensagens da Cloud API para o phone number id do número ligado. 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 são apresentados na interface do Flow e são ocultados nos registos de execução, que é o sítio certo para um token. O corpo é uma mensagem de template, com o número de telefone do cliente no campo to e os dados da encomenda como parâmetros do template.

O Flow considera uma resposta 2XX ou 3XX um sucesso. A Meta responde a um pedido válido com o id da mensagem, pelo que 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}}" }]
    }]
  }
}

Porque é que uma mensagem de encomenda tem de ser um template?

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

Crie o template uma só vez, na categoria utility, para atualizações de encomendas e envios, e aguarde a aprovação antes de ativar o fluxo de trabalho. O nome e o idioma no corpo do pedido têm de corresponder exatamente ao template aprovado, e o número de parâmetros tem de corresponder aos seus marcadores.

Há também o consentimento. A Meta exige opt-in antes de uma empresa enviar mensagens a alguém no WhatsApp: a pessoa forneceu o seu número e aceitou receber mensagens dessa empresa. Uma caixa de seleção no checkout que o indique é a forma habitual de o recolher, e o fluxo de trabalho deve verificá-lo antes de enviar.

E se o plano da loja não incluir Send HTTP request?

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

Seja qual for o caminho de envio, as respostas são iguais. Quando o cliente responde à mensagem da encomenda, a resposta chega à app WhatsApp Business no telemóvel da loja, porque o número está em Coexistence, e a janela de 24 horas fica aberta para texto livre. Se o destino do webhook do número estiver definido, a resposta chega também ao seu sistema. A própria mensagem da encomenda também aparece na app, para que quem responde veja aquilo a que o cliente está a responder.

Erros comuns

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

Perguntas frequentes

Continue a ler