WhatsApp-orderberichten versturen vanuit Shopify

Hoe verstuurt Shopify Flow een WhatsApp-bericht?

Met de actie Send HTTP request, die naar elke URL post met headers en een body waarin je Liquid-variabelen uit de trigger kunt gebruiken.

Bouw een workflow op de trigger voor het aanmaken van een order en voeg Send HTTP request toe. De URL is het endpoint /messages van de Cloud API voor het telefoonnummer-ID van het gekoppelde nummer. Voeg een Authorization-header toe met als waarde Bearer gevolgd door het access token van het nummer, opgeslagen als Flow-secret en aangeroepen als geheime variabele. Geheime waarden zijn nooit zichtbaar in de Flow-interface en worden verborgen in de uitvoerlogs, en daar hoort een token ook thuis. De body is een templatebericht, met het telefoonnummer van de klant in het veld to en de ordergegevens als parameters van het template.

Flow beschouwt een 2XX- of 3XX-antwoord als geslaagd. Meta beantwoordt een geldig verzoek met de ID van het bericht, dus een geslaagde run betekent dat Meta het bericht heeft geaccepteerd.

{
  "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}}" }]
    }]
  }
}

Waarom moet een orderbericht een template zijn?

Omdat de winkel als eerste schrijft. Het 24-uursvenster voor klantenservice van Meta gaat pas open als de klant het nummer een bericht stuurt. Een orderbevestiging, een verzendupdate of een herinnering voor een verlaten checkout wordt daarvoor verstuurd, dus vrije tekst wordt geweigerd en alleen een vooraf goedgekeurd template komt door.

Maak het template één keer aan, in de categorie utility voor order- en verzendupdates, en wacht op goedkeuring voordat je de workflow aanzet. De naam en taal in de body van het verzoek moeten exact overeenkomen met het goedgekeurde template, en het aantal parameters moet overeenkomen met de placeholders.

Daarnaast is er toestemming. Meta eist opt-in voordat een bedrijf iemand via WhatsApp berichten stuurt: de persoon heeft het nummer opgegeven en ingestemd met berichten van dit bedrijf. Een selectievakje bij de checkout dat dit vermeldt is de gebruikelijke manier om die toestemming te verzamelen, en de workflow moet dit controleren voordat er iets wordt verstuurd.

Wat als het abonnement van de winkel geen Send HTTP request bevat?

Gebruik dan een Shopify-admin-webhook. Onder Instellingen, Notificaties, Webhooks kan een verkoper een webhook aanmaken voor een gebeurtenis zoals het aanmaken van een order, in JSON, naar een URL. Wijs die naar een ontvanger: een n8n Webhook-node, of een route in PHP, Python of Node. De ontvanger leest de order, controleert de toestemming en doet dezelfde template-aanroep naar de Cloud API.

Welk pad er ook verstuurt, antwoorden werken hetzelfde. Als de klant het orderbericht beantwoordt, komt het antwoord binnen in de WhatsApp Business-app op de telefoon van de winkel, omdat het nummer op Coexistence zit, en staat het 24-uursvenster open voor vrije tekst. Als de webhook-URL van het nummer is ingesteld, bereikt het antwoord ook jouw systeem. Het orderbericht zelf verschijnt ook in de app, zodat wie antwoordt ziet waarop de klant reageert.

Veelgemaakte fouten

• Vrije tekst versturen bij het aanmaken van een order. De klant heeft nog niet geschreven, dus Meta weigert het; het moet een goedgekeurd template zijn.
• De foutafhandeling op Retry laten staan voor 4XX-antwoorden. Flow kan tot 24 uur lang een verzoek blijven herhalen dat Meta nooit accepteert.
• Het token als platte tekst in een header zetten. Sla het op als Flow-secret, zodat het uit de interface en de logs blijft.

Veelgestelde vragen

Lees verder