Skip to main content
Addy is AdsEra’s AI agent. It answers your customers on WhatsApp, asks your qualifying questions, scores every lead, books meetings and takes orders. You set it up once in AI Agent. With the Addy API, your own CRM or backend can:
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.
Customers are found by phone number with the country code, for example 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.