Dla programistów
Co można dziś połączyć z Kallina z kodu
Kallina nie ma jeszcze udokumentowanego publicznego API REST. Ma cztery działające punkty integracji: narzędzia webhook wywoływane przez asystenta podczas rozmowy, adresy uruchamiające przepływy, skrypt przycisku głosowego i serwer MCP. Dostęp do API dla szczególnych przypadków omawiamy na życzenie.
Punkty połączenia
Webhooki podczas rozmowy
W karcie asystenta definiuje się narzędzie: nazwa, opis, adres, metoda, schemat pól i maksymalny czas oczekiwania. Asystent wywołuje je, gdy wymaga tego rozmowa, i używa odpowiedzi w zdaniu.
Adresy uruchamiające fluxy
Przepływ z konstruktora może mieć własny adres wyzwalający. Wasz system wysyła żądanie, a przepływ startuje z otrzymanymi danymi.
Przycisk głosowy na stronie
Jeden skrypt na stronie. Sesja głosowa otrzymuje tymczasowy adres, więc identyfikator asystenta nie pojawia się w kodzie strony.
Serwer MCP
Asystenci zgodni z MCP mogą połączyć się z kontem Kallina przez autoryzację OAuth, aby odczytywać asystentów, połączenia i potencjalnych klientów albo uruchamiać połączenia.
Przycisk głosowy: kod do wklejenia
Skrypt ładuje się prosto, nie jako moduł i nie przez bundler.
<script src="https://app.kallina.info/embed.js" data-widget="WIDGET_ID"></script>
<script>
window.KallinaVoice.on("state", (s) => console.log(s)); // idle | connecting | listening | speaking
window.KallinaVoice.on("message", (m) => console.log(m.source, m.text));
// window.KallinaVoice.start() / window.KallinaVoice.stop()
</script>| Atrybut | Co robi |
|---|---|
| data-widget | Publiczny identyfikator widgetu. Wymagane. |
| data-mode | „button” wyświetla przycisk; „inline” nic nie wyświetla i pozostawcie uruchamianie po stronie swojego kodu. |
| data-position | Róg przycisku: prawy dolny lub lewy dolny. |
| data-color | Kolor przycisku. |
| data-label | Etykieta dostępności przycisku. |
Uwierzytelnianie adresów przepływu
| Metoda | Kiedy jej używać |
|---|---|
| Bez uwierzytelniania | Tylko do testów, w przepływach, które nie obejmują danych osobowych. |
| Podstawowy | Nazwa użytkownika i hasło, dla systemów, które niczego innego nie obsługują. |
| Własny nagłówek | Nagłówek z tajną wartością ustawioną przez Was. |
| Bearer | Token w nagłówku autoryzacji. |
Dostępne narzędzia MCP
Poniższe nazwy są zgodne z serwerem. Dostęp jest przyznawany na konto, po autoryzacji.
- list_agents
- get_agent
- update_agent_prompt
- list_phone_numbers
- list_calls
- get_call_transcript
- list_leads
- export_leads
- start_outbound_call
- list_campaigns
- start_campaign
- account_status
Najczęściej zadawane pytania
Czy macie API REST z kluczami?
Niepubliczne. Jeśli potrzebujecie uruchamiać połączenia lub odczytywać wyniki z Waszego systemu, napiszcie nam o swoim przypadku, a ustalimy dostęp i jego formę.
Czy otrzymuję webhook z wynikiem po każdym połączeniu?
Nie jako usługa standardowa. Wynik jest przekazywany przez przepływy albo przez istniejące integracje; dla stałego formatu omawiamy to w projekcie.
Czy istnieje dokumentacja?
Dla przycisku głosowego i narzędzi webhook opis na tej stronie oraz pomoc w aplikacji. Dla każdego dodatkowego dostępu dokumentację otrzymujecie na starcie projektu.
Czy narzędzia webhook muszą odpowiadać szybko?
Tak. Każde narzędzie ma maksymalny czas oczekiwania; powolna odpowiedź oznacza przerwę w rozmowie, więc trzymajcie zapytania krótkie.
Opiszcie nam, co chcecie połączyć
Napiszcie, jaki system, jakie dane i w którym momencie rozmowy. Odpowiemy, co da się zrobić z tym, co jest, a co trzeba zbudować.