Install FXMacroData on WhatsApp Business API

Setting it up

1. 01

   Register the WhatsApp Business API surface

   Add it in API Management and copy the redistribution key. Registering enables access immediately; there is no review queue.

2. 02

   Derive the user reference

   For WhatsApp Business API, use the recipient phone number, hashed. Hash it with a secret only you hold, so the value we store cannot be reversed and cannot be correlated with anyone else's report.

   user_ref = hmac_sha256(
       key=YOUR_SECRET,
       message=recipient_number,
   ).hexdigest()

3. 03

   Report once per person per billing period

   Send the reference the first time you serve that person in the period, then mark them done. Repeats are free, so a retry or a replay is never a problem.

   POST https://fxmacrodata.com/partner-meter/v1/audience
   Authorization: Bearer <your redistribution key>
   Content-Type: application/json
   
   {
     "surface_id": "WhatsApp Business API",
     "user_ref": "<hmac of recipient_number>"
   }

4. 04

   Show the attribution

   The FXMacroData credit has to be visible wherever the data appears, in the same view as the data itself.

Confirming it works

1. 1 Send one report for a test user and confirm a 202 response.
2. 2 Send the same reference again and confirm the billable count does not move.
3. 3 Open API Management and confirm the measured user appears against this surface.

Reference

Shared detail that applies to every authenticated channel, kept in one place rather than restated here.