This is Addy, AdsEra’s own AI agent. The Meta Business AI endpoints are for Meta’s agent, which some businesses switch on in WhatsApp Manager instead. If you use Addy, you don’t need them.
Authentication
The same API key as the rest of the API: create one in Settings → API Keys and send both headers.919876543210. Spaces, + and dashes are ignored. If you have several WhatsApp numbers, AdsEra uses the one Addy last talked to that customer on. Send whatsapp (a number id from List WhatsApp Numbers) to choose one.
A typical setup
1
Get leads as Addy finds them
Subscribe to the
addy.lead_updated webhook in Settings → Webhooks. Each time Addy moves a lead to a new stage or temperature, your CRM gets the score, the reason and the chat summary. To catch up, call List Addy’s Leads with updatedSince.2
Alert your team when Addy needs a person
Subscribe to
addy.handoff. It arrives when a customer asks for a human, or when Addy can’t help. It has Addy’s summary, so your salesperson knows the context before replying.3
Take over and hand back from your CRM
When your salesperson starts replying, call Take a Chat from Addy. When they’re done, call Hand a Chat Back to Addy. AdsEra also does this automatically: replying from the AdsEra inbox takes the chat, and Addy takes back chats that have been quiet for a while; you set how long in your AI Agent settings.
4
Keep customers updated
When an order ships or a payment comes in, call Send an Event to Addy. Addy tells the customer in its own words, using only the facts you send.
Lead scores
Addy scores every customer from 0 to 100, from what they tell it, such as budget, need, timeline and whether they decide. The thresholds in your AI Agent settings turn the score into a temperature:
The stage shows how far they got:
new → engaged → qualified → hot → booked / ordered → paid, or lost.
The score, temperature and stage are also saved on the contact as LEAD_SCORE, LEAD_TEMPERATURE and LEAD_STAGE. So they also appear in CRM contacts.