Бүтүмдөрдүн жыйынтыктарын WazzaBee'ге API аркылуу берүү

amoCRM'де иштейсизби? Бул ыкманы чакыруунун кереги жок: amoCRM коннекторунун жөндөөлөрүндө сатуу деп эсептелген этаптарды белгилеңиз, менеджер бүтүмдү ошол этапка которгондо сатуу өзү жөнөтүлөт. Кененирээк «amoCRM туташтыруу» макаласынын «Бүтүм этабы боюнча Meta'дагы сатуулар» бөлүмүндө.

Бул эмне үчүн керек

WazzaBee ар бир кардар кайсы жарнамадан келгенин билет, бирок сүйлөшүү эмне менен бүткөнүн билбейт: бул маалымат сиздин CRM'иңизде. Бүтүмдүн жыйынтыгын бизге бериңиз, ошондо «Жарнама» бөлүмүндө ар бир жарнама боюнча сатуулар, киреше жана орточо чек пайда болот: кайсы креатив акча алып келерин, кайсынысы жөн гана кайрылууларды алып келерин көрөсүз.

Эгер «Жарнама» бөлүмүндө «Meta'дагы сатуулар» туташтырылса жана кардар «WhatsApp'ка жазуу» жарнамасынан келсе, сатуу жана максаттуу лид Meta'га жөнөтүлөт. Ошондо жарнама сатып алуучулардан үйрөнөт. Кененирээк «Жарнама жана Meta CAPI» макаласында.

Интеграциясыз да иштейт. Өзүңүздүн CRM болбосо, менеджер жыйынтыкты түз эле WazzaBee чатында белгилейт: кардардын атынын жанындагы баскыч. Ыкма бир эле нерсени эки жолу толтургусу келбегендерге керек.

POST /v1/outcomes

URL

POST https://api.wazzabee.com/api-gateway/v1/outcomes

Аталыштар

Authorization: Bearer СИЗДИН_API_АЧКЫЧ
Content-Type: application/json

Суроо-талаптын денесинин параметрлери

Параметр	Түрү	Милдеттүү	Сүрөттөмө
`chatId`	string	✅ Ооба*	Кардардын телефону же анын мессенджердеги идентификатору. Ушул байланыштын акыркы диалогун алабыз
`conversationId`	string (UUID)	✅ Ооба*	Диалогдун идентификатору, эгер ал сизде сакталган болсо. `chatId`'ге караганда так
`outcome`	string	✅ Ооба	`sale`: сатуу, `qualified`: максаттуу лид, `refused`: баш тартуу, `no_answer`: жооп бербейт
`amount`	number	`sale` үчүн	Сатуунун суммасы. Ансыз сатууну кабыл ала албайбыз: өзүн актоо отчетунда эсептей турган эч нерсе болбойт
`currency`	string	Жок	Сумманын валютасы, демейки боюнча `KZT`
`channelId`	string (UUID)	Жок	Байланыш линиясы. Бир эле номер сизге бир нече линияга жазса, көрсөтүңүз
`comment`	string	Жок	Эскертме: эмне сатып алышты, чоо-жайы. 500 белгиге чейин

* chatId же conversationId, жок дегенде бирөөсү керек.

Суроо-талаптын мисалы

curl -X POST "https://api.wazzabee.com/api-gateway/v1/outcomes" \
  -H "Authorization: Bearer СИЗДИН_API_АЧКЫЧ" \
  -H "Content-Type: application/json" \
  -d '{
    "chatId": "77071234567",
    "outcome": "sale",
    "amount": 185000,
    "comment": "Испанияга виза, толук төлөндү"
  }'

Жооп

{
  "success": true,
  "conversationId": "uuid",
  "outcome": "sale",
  "amount": 185000,
  "currency": "KZT"
}

Каталар

Код	Себеби
400	`outcome` көрсөтүлгөн эмес же белгисиз; сатуу үчүн `amount` берилген эмес; `chatId` да, `conversationId` да көрсөтүлгөн эмес
403	Линия сиздин интеграцияңызга байланган эмес
404	Диалог табылган жок: кардар сизге азырынча жаза элек же номер ал кайрылган номерден айырмаланат

Муну өзүңүздүн CRM'ге кантип киргизүү керек

Бүтүм этабын алмаштырган учурда ыкманы чакырыңыз. Бир өтүүгө бир чакыруу, ушул жетиштүү.

Бүтүм төлөндү → outcome: "sale" жана төлөмдүн суммасы;
Кардар квалификацияланды, бирок азырынча төлөй элек → outcome: "qualified";
Баш тартуу → outcome: "refused";
Байланышка чыкпайт → outcome: "no_answer".

Сатуу бул кызмат ийгиликтүү болгондо эмес, акча келгенде. Эгер кардар төлөп, бирок жыйынтык терс болсо (мисалы, визадан баш тартышты, бирок кызмат төлөнгөн), биз үчүн бул баары бир төлөм суммасы менен sale. Иштин жыйынтыгын эмес, акчаны эсептейбиз.

Ошол эле диалог боюнча кайра чакыруу мурунку жыйынтыкты кайра жазат: менеджер катаны оңдой алат, бизде актуалдуу маани калат. Кайталоолор болбойт.