Quickstart

Send your first WhatsApp message in 5 minutes. You'll need a WhatsApp Business number connected to your Envara account (done once, in Settings).

1. Create a site

In the dashboard, go to Sites → Add site. Pick the platform that matches your stack:

  • WooCommerce — install the WordPress plugin, paste the API key, done. Skip steps 2–3 below; the plugin handles signing for you.
  • Shopify — register an outgoing webhook pointed at your ingest URL with the secret as the HMAC key.
  • Custom / API (Node, PHP, Python, mobile, n8n, …) — sign your own requests as shown below.

You'll be shown an API key and webhook secret exactly once — copy both into your app's secret manager.

2. Sign and send an event

Pick any event name (lowercase, dotted: resource.action). Build the JSON body. Compute an HMAC-SHA256 signature of the raw body using your webhook secret. Include the headers below.

curl
SITE_KEY="ec_live_xxxxxxxx..."SECRET="ecs_xxxxxxxx..."BODY='{"event":"order.created","order":{"id":"1","number":"1042","total":"199.00","currency":"AED","customer":{"first_name":"Ada","phone_e164":"+9715XXXXXXXX"}}}'TS=$(date +%s)SIG=$(printf '%s' "$BODY" | openssl dgst -sha256 -hmac "$SECRET" | awk '{print $2}')
curl -X POST https://bridge.envara.ae/api/public/ingest/generic/order.created \  -H "Content-Type: application/json" \  -H "X-Envara-Site-Key: $SITE_KEY" \  -H "X-Envara-Signature: sha256=$SIG" \  -H "X-Envara-Timestamp: $TS" \  -d "$BODY"

3. Check that we received it

Open Sites → your site. The event should appear in the live event feed within seconds.

4. Wire a WhatsApp template

Open Templates. Create or pick an approved WhatsApp template (or ask Eva to draft one for you). Then in Notifications, create a binding: pick your event (order.created), pick the template, map each {{1}} slot to a path in your payload (e.g. order.customer.first_name). Save.

5. Trigger again — get a WhatsApp message

Re-send the same request. This time the binding fires and the customer's phone receives the templated message.

Test without sending

Set X-Envara-Mode: test on any request to run validation + binding resolution and return a preview of what would be sent, without calling Meta or charging you. Great for development.

Next