Ringostat
Zaloguj

Zamówienia i leady: KeyCRM

~8 min · Agent znajduje zamówienia dzwoniącego w KeyCRM, potwierdza je lub anuluje, zostawia menedżerowi notatkę i tworzy leady z połączeń przychodzących.
Co otrzymasz:
po numerze dzwoniącego agent widzi jego zamówienia w KeyCRM: status, produkty, kwotę, dostawę i numer przesyłki. Po rozmowie sam ustawia zamówieniu status „potwierdzone”, „odmowa” lub „oddzwonić” i dopisuje menedżerowi podsumowanie. Dla zapytania bez zamówienia tworzy kartę w lejku. Dostępność produktu sprawdza po SKU.
Co przygotować:
konto KeyCRM, w którym widzisz klucz API (widzi go właściciel konta), uprawnienia administratora projektu w Voice Agent i kampania „Voice Agent”.

1. Skopiuj klucz API w KeyCRM

W KeyCRM otwórz „Ustawienia” → „Podstawowe” i skopiuj klucz z wiersza „API key”. Jeśli klucza jeszcze nie ma, kliknij „Wygeneruj klucz API”.

2. Podłącz integrację

  1. 1
    Menu po lewej → „Integrations” (integracje) → „Ready-made” (gotowe integracje) → zakładka „CRM” → karta „KeyCRM” → „Połącz”.
  2. 2
    Wklej klucz w pole „Klucz API” i kliknij „Zapisz”.
  3. 3
    Kliknij „Testuj połączenie”. Jeśli wszystko jest w porządku, pojawi się „Połączenie działa: klucz API odczytuje statusy Twoich zamówień.”, a statusy i lejki wczytają się do formularza poniżej.
Klucz jest przechowywany w postaci zaszyfrowanej i po zapisaniu nie jest wyświetlany. Aby go zastąpić, wpisz nowy; puste pole zachowuje zapisany. Po wpisaniu nowego klucza najpierw go zapisz, a dopiero potem wczytuj statusy: listy są czytane z zapisanym kluczem.

3. Przypisz wyniki rozmowy do statusów zamówień

W bloku „Zamówienia po rozmowie” kliknij „Wczytaj statusy z KeyCRM”: pola zmienią się w listy statusów Twojego konta. Wcześniej ID statusów można wpisać ręcznie.

Pozwól agentowi zmieniać statusy zamówieńGłówny przełącznik. Wyłączony: agent tylko odczytuje zamówienia i zostawia komentarze, a przypisanie poniżej zostaje zachowane. Domyślnie włączony.
Klient potwierdziłStatus, który agent ustawia, gdy klient potwierdzi zamówienie.
Klient odmówiłStatus dla odmowy lub anulowania.
Prosi o oddzwonienieStatus, gdy klient prosi o telefon później.
Brak odpowiedziStatus dla połączenia, w którym klient właściwie nie rozmawiał. Ustawia go tylko narzędzie po rozmowie (patrz niżej).
Statusy, które agent może zmieniaćZamówienia w innych statusach (już wysłane, opłacone) pozostają nietknięte. Puste: dowolny status. Zwykle tylko „Nowe” i „Oczekuje na potwierdzenie”.
Wynik bez statusu nie jest dostępny dla agenta: nie zmieni on zamówienia, jeśli dla tego wyniku nie ustawiono statusu. Statusy zmieniają się w roboczej bazie sklepu, więc pierwsze połączenia testowe wykonuj z wyłączonym przełącznikiem lub na zamówieniach testowych.

4. Leady i limit zapytań

Pozwól agentowi tworzyć leadyWyłączone: agent nie tworzy kart w lejku, a wybrany lejek zostaje zachowany.
Lejek dla nowych leadówGdzie agent tworzy kartę dla zapytania bez zamówienia. Puste: agent nie tworzy leadów.
Źródło leadaOpcjonalnie. Źródło KeyCRM ustawiane na nowych kartach.
Dzienny limit zapytań do APIKeyCRM pozwala na 20 zapytań na minutę na klucz, wspólnie z Twoją stroną i marketplace'ami. Agent używa najwyżej 15 na minutę i najwyżej tylu dziennie (domyślnie 5000).

Zapisz ustawienia.

5. Podłącz do kampanii

  1. 1
    Edytor kampanii → karta „Narzędzia AI” → wybierz KeyCRM: wszystkie narzędzia albo tylko zaznaczone.
    Narzędzia AI
    Narzędzia AI
  2. 2
    Zapisz kampanię.
search_entities_by_phoneKupujący i jego ostatnie zamówienia po numerze dzwoniącego: status, produkty, kwota, dostawa, numer przesyłki. Agent wywołuje je jako pierwsze.
get_orderSzczegóły jednego zamówienia dzwoniącego. Komentarz menedżera agent traktuje jako notatkę wewnętrzną i nie odczytuje go klientowi.
update_order_statusUstawia status zamówienia według wyniku rozmowy: confirmed, declined, callback lub no_answer — tylko te, dla których ustawiono status.
add_order_commentDopisuje menedżerowi notatkę z datą i oznaczeniem Voice Agent. Istniejący komentarz zostaje.
create_lead, update_leadKarta w lejku z telefonem dzwoniącego, imieniem, komentarzem i produktami po SKU; zmiana jej statusu, czas oddzwonienia, notatka.
list_order_statuses, list_stagesStatusy zamówień i statusy lejka, żeby agent nie wymyślał ID.
check_stockCzy produkt jest dostępny po SKU: nazwa, cena i wolna ilość.
Agent pracuje tylko z zamówieniami, w których numer kupującego lub odbiorcy zgadza się z numerem dzwoniącego. Cudze zamówienie jest niedostępne nawet po dokładnym numerze. KeyCRM nie pozwala wyszukiwać kart lejka po telefonie, więc agent zmienia tylko kartę utworzoną w tym połączeniu albo tę, której ID przekazano w numerze jako lead_id.

Scenariusz 1. Potwierdzanie nowych zamówień

Kampania wychodząca dzwoni do kupujących z nowymi zamówieniami. Wgraj numery plikiem CSV z kolumnami phone i order_id (możesz dodać name, total) albo przez API z customFields. Te dane agent widzi automatycznie w danych klienta. Przykład instrukcji:

Dzwonisz do kupującego, aby potwierdzić zamówienie w sklepie internetowym.
1. Najpierw wywołaj search_entities_by_phone i znajdź zamówienie z order_id klienta.
2. Wymień produkty, kwotę i sposób dostawy. Nie odczytuj komentarza wewnętrznego.
3. Klient potwierdził → update_order_status z outcome=confirmed i krótkim
   komentarzem (adres, życzenia dotyczące dostawy).
4. Odmówił → zapytaj o powód, update_order_status z outcome=declined
   i powodem w komentarzu.
5. Prosi o oddzwonienie → ustal dogodny czas, update_order_status
   z outcome=callback i czasem w komentarzu.
Nie zmieniaj statusu, dopóki klient nie odpowie jednoznacznie.

Scenariusz 2. Odmowy i „proszę zadzwonić później”

Ta sama kampania obsługuje obiekcje: jeśli klient waha się z powodu produktu, agent sprawdza zamiennik przez check_stock i go proponuje. Jeśli klient mimo to odmawia, agent ustawia „Klient odmówił” i zapisuje powód w komentarzu, żeby menedżer widział go w zamówieniu. Przykład uzupełnienia instrukcji:

Jeśli klient chce inny rozmiar lub kolor, sprawdź check_stock po SKU
z zamówienia i powiedz, co jest dostępne. Nie zamieniaj sam: dopisz
życzenie przez add_order_comment, menedżer oddzwoni.
Powód odmowy zawsze zapisuj w komentarzu jednym zdaniem.
Połączeń, na które nikt nie odpowiedział, Voice Agent nie oznacza w KeyCRM. Widać je w statystykach kampanii, a do swojego systemu możesz je przekazać webhookiem.

Scenariusz 3. Połączenia przychodzące → leady

Kampania przychodząca na numerze sklepu. Jeśli dzwoniący ma zamówienie, agent odpowiada o jego statusie i numerze przesyłki. Jeśli zamówienia nie ma, a klient interesuje się produktem, agent tworzy kartę w lejku. Przykład instrukcji:

Najpierw wywołaj search_entities_by_phone.
- Jest zamówienie → odpowiadaj o statusie, dostawie i numerze przesyłki.
- Nie ma zamówienia, a klient chce kupić → zapytaj o imię, produkt (SKU,
  jeśli zna) i dogodny czas na telefon menedżera. Utwórz lead przez
  create_lead: krótki tytuł, komentarz z życzeniami, produkty w items.
- Klient prosi o telefon o konkretnej godzinie → update_lead
  z callback_at dla właśnie utworzonej karty.

Po rozmowie zamiast agenta

Status można ustawiać nie w trakcie rozmowy, lecz automatycznie po niej, na podstawie raportu AI. Agent nie rozprasza się wtedy na CRM, a status zostaje ustawiony nawet wtedy, gdy klient rozłączył się wcześniej.

  1. 1
    Edytor kampanii → karta „Ekstrakcja danych” → „+ Dodaj pole”: dodaj pole order_outcome z opisem „confirmed, jeśli klient potwierdził zamówienie; declined, jeśli odmówił; callback, jeśli prosił o oddzwonienie; no_answer, jeśli nie było właściwej rozmowy” oraz pole summary na podsumowanie rozmowy.
  2. 2
    Ustaw narzędzia KeyCRM na moment „Po połączeniu” z parametrami-szablonami. W edytorze kampanii nie ma jeszcze pól na parametry, więc robi się to przez serwer MCP Voice Agent (voiceagent_set_campaign_integration_tools) albo API.
{ "projectID": 123, "campaignID": 456, "integrationId": "keycrm",
  "tools": [ "search_entities_by_phone", "get_order", "check_stock", "add_order_comment",
  { "name": "update_order_status", "usageTiming": "afterCall",
    "parameters": { "order_id": "${custom_fields.order_id}",
                    "outcome": "${report.detailed.order_outcome}",
                    "comment": "${report.detailed.summary|}" } } ] }

Zastąp 123 i 456 ID swojego projektu i kampanii. W tools wymień wszystkie narzędzia KeyCRM, które mają zostać w kampanii: narzędzia spoza listy zostaną odłączone. Sama nazwa (jak search_entities_by_phone) zostawia narzędzie dostępne w trakcie rozmowy. Jeśli numer nie ma order_id albo raport nie ma order_outcome, narzędzie się nie wykona i zamówienie się nie zmieni. Ponowne uruchomienie dla tego samego połączenia nie dubluje statusu ani komentarza.

Wyniki w webhooku

W szablonie treści webhooka kampanii możesz przekazać wyniki narzędzi: {{tools.keycrm_create_lead.lead_id?}} — ID utworzonej karty, {{tools.keycrm_update_order_status.status_id?}} — ustawiony status. Znak ? oznacza, że pole będzie null, jeśli narzędzie nie zostało wywołane w rozmowie.

Co dalej