Мәміле нәтижелерін 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. Іс нәтижесін емес, ақшаны есептейміз.

Сол диалог бойынша қайталап шақыру бұрынғы нәтижені қайта жазады: менеджер қатені түзете алады, ал бізде өзекті мән қалады. Қайталанулар болмайды.