Pour les développeurs
Ce que vous pouvez lier à Kallina depuis le code, aujourd'hui
Kallina n'a pas encore d'API REST publique documentée. Elle dispose de quatre points de liaison qui fonctionnent : des outils webhook appelés par l'agent pendant la conversation, des adresses qui déclenchent des flux, le script pour le bouton vocal et un serveur MCP. L'accès à l'API pour des cas spéciaux se discute à la demande.
Points de liaison
Outils webhook pendant l'appel
Dans la fiche de l'agent, définissez un outil : nom, description, adresse, méthode, schéma des champs et délai d'attente maximal. L'agent l'appelle quand la conversation l'exige et utilise la réponse dans la phrase.
Adresses qui déclenchent des flux
Un flux du constructeur peut avoir sa propre adresse de déclenchement. Votre système envoie une requête, et le flux démarre avec les données reçues.
Le bouton vocal sur le site
Un seul script sur la page. La session vocale reçoit une adresse temporaire, donc l'identifiant de l'agent n'apparaît pas dans le code de la page.
Serveur MCP
Les assistants compatibles MCP peuvent se connecter au compte Kallina via une autorisation OAuth, pour lire les agents, les appels et les leads ou pour lancer des appels.
Le bouton vocal : le code à insérer
Le script se charge simplement, pas comme module et pas via un 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>| Attribut | Ce que cela fait |
|---|---|
| data-widget | Identifiant public du widget. Obligatoire. |
| data-mode | « button » affiche le bouton ; « inline » n'affiche rien et vous laissez le démarrage à votre code. |
| data-position | Coin du bouton : en bas à droite ou en bas à gauche. |
| data-color | La couleur du bouton. |
| data-label | Le libellé accessible du bouton. |
Authentification des adresses du flux
| Méthode | Quand l’utiliser |
|---|---|
| Sans authentification | Uniquement pour les tests, sur des flux qui n’atteignent pas de données personnelles. |
| Basic | Nom d’utilisateur et mot de passe, pour les systèmes qui ne savent rien d’autre. |
| En-tête personnalisé | Un en-tête avec une valeur secrète définie par vous. |
| Bearer | Un token dans l’en-tête d’autorisation. |
Outils MCP disponibles
Les noms ci-dessous sont ceux du serveur. L’accès se fait par compte, après autorisation.
- 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
Questions fréquentes
Avez-vous une API REST avec des clés ?
Non, pas publique. Si vous devez lancer des appels ou lire des résultats depuis votre système, écrivez-nous votre cas et nous définirons l’accès et sa forme.
Est-ce que je reçois un webhook avec le résultat après chaque appel ?
Pas en tant que service standard. Le résultat est envoyé via des flux ou par les intégrations existantes ; pour un format fixe, nous en discutons dans le projet.
Y a-t-il de la documentation ?
Pour le bouton vocal et les outils webhook, la description sur cette page et l’aide dans l’application. Pour tout accès supplémentaire, vous recevez la documentation au lancement du projet.
Les outils webhook doivent-ils répondre rapidement ?
Oui. Chaque outil a un délai d’attente maximal ; une réponse lente signifie une pause dans la conversation, donc gardez les requêtes courtes.
Décrivez-nous ce que vous voulez relier
Dites quel système, quelles données et à quel moment de l’appel. Nous vous répondons ce qui est possible avec ce qui existe et ce qu’il faut construire.