allo
ProduitLanguesDémarrerPrixSécuritéQuestions
Connexion
Sur cette pageDémarrerWidget pour votre siteAuthentificationParler à l'agentToutes les routesFlutter et mobileServeur MCPCRM et automatisationsLimites et erreurs
Développeurs

Intégrez allo. partout

Un widget pour votre site en une ligne, une API REST pour vos applications, votre CRM et vos automatisations. Tout partage les mêmes clés, les mêmes quotas et la même documentation.

Démarrer en trois minutes

  1. Créez votre compte gratuit et configurez votre agent.
  2. Dans votre espace, ouvrez la rubrique Développeurs : copiez le code du widget, ou créez une clé d'API (toutes les formules : 1 clé en Free, 5 en Go, 10 en Starter, illimité en Premium).
  3. Collez le code dans votre site, ou faites votre premier appel ci-dessous.

Créer mon compte

Le widget : une ligne dans votre site

Un bouton de discussion apparaît en bas de chaque page, avec chat et voix. Aucune clé n'est nécessaire, c'est inclus dans toutes les formules, Free comprise.

<script src="https://www.allo.africa/embed.js"
  data-agent="votre-entreprise" async></script>
html

Options : data-color (couleur du bouton), data-position="left", data-label (texte du bouton), data-open="true" (ouvert au chargement), data-lang. Pilotage par code : AlloWidget.open(), AlloWidget.close(), AlloWidget.toggle().

Voix et micro. Pour que la conversation vocale fonctionne dans le widget, votre site doit autoriser le micro à ses cadres. Si votre serveur envoie un en-tête Permissions-Policy avec microphone=(), remplacez-le par microphone=(self "https://votre-entreprise.allo.africa"). Si votre site a aussi une politique Content-Security-Policy, autorisez https://www.allo.africa dans script-src, et https://*.allo.africa dans frame-src, connect-src et wss://*.allo.africa dans connect-src. Sans cela, le widget masque simplement la voix et reste utilisable en chat.

Vous préférez une page intégrée ? Utilisez une iframe vers https://votre-entreprise.allo.africa/?widget=1 avec allow="microphone".

Authentification

Toutes les requêtes portent une clé d'API dans l'en-tête Authorization: Bearer …. Deux types de clés, créées dans l'espace, rubrique Développeurs :

Clé secrèteallo_sk_…

Pour votre serveur ou votre CRM. Accès complet : conversations, connaissances, tickets, consommation. Ne la mettez jamais dans un site ni dans une application mobile : elle est refusée si l'appel vient d'un navigateur.

Clé publiqueallo_pk_…

Pour discuter avec l'agent depuis un site ou une application. Elle ne fonctionne que depuis les sites que vous déclarez, et ne permet que le chat.

Parler à l'agent

Passez toujours le même userId pour une même personne (identifiant client, contact CRM…) : l'agent retrouve ses conversations et sa mémoire. Chaque message compte dans le quota mensuel de votre formule.

curl https://www.allo.africa/api/v1/chat \
  -H "Authorization: Bearer allo_sk_VOTRE_CLE" \
  -H "Content-Type: application/json" \
  -d '{"message": "Quels sont vos horaires ?", "userId": "client-42"}'

Réponse :

{
  "conversationId": "01a1...",
  "reply": "Nous sommes ouverts du lundi au samedi, de 8h à 18h.",
  "links": [],
  "suggestions": ["Où êtes-vous situés ?"],
  "citations": [{ "title": "Horaires", "url": "https://..." }],
  "human": false,
  "ticket": null
}
json

Pour afficher la réponse au fur et à mesure, utilisez POST /chat/stream : événements meta, delta (morceaux de texte), puis done avec la réponse complète.

Toutes les routes

Adresse de base : https://www.allo.africa/api/v1. La description complète est disponible au format OpenAPI : openapi.json, à importer dans Postman, Insomnia ou votre générateur de client.

POST/chatEnvoyer un message et recevoir la réponseToute clé
POST/chat/streamMême chose en flux (Server-Sent Events)Toute clé
GET/agentNom, accueil, couleurs et contacts de l'agentToute clé
GET/conversationsLister les conversations (pagination par curseur)Clé secrète
GET/conversations/{id}Lire les messages d'une conversationClé secrète
GET/knowledgeLister les sources de connaissancesClé secrète
POST/knowledgeAjouter un site, un texte ou une question-réponseClé secrète
DELETE/knowledge/{id}Supprimer une sourceClé secrète
GET/ticketsLister les tickets (conversations transmises aux conseillers)Clé secrète
GET/tickets/{id}Lire un ticket et son historiqueClé secrète
POST/tickets/{id}/replyRépondre au client depuis votre outilClé secrète
GET/usageFormule, quotas et consommation du moisClé secrète

Ajouter une connaissance :

POST /knowledge
{ "type": "url", "url": "https://www.mon-site.com/faq", "mode": "page" }
{ "type": "text", "title": "Livraison", "content": "Nous livrons en 48 heures..." }
{ "type": "faq", "question": "Acceptez-vous Wave ?", "answer": "Oui, Wave et Orange Money." }
json

Flutter et applications mobiles

Deux façons, selon votre besoin :

Le plus rapide : une WebView

Affichez la page de l'agent dans votre application, chat et voix compris. Avec webview_flutter : loadRequest(Uri.parse('https://votre-entreprise.allo.africa/?widget=1')). Autorisez le micro dans votre application (Android et iOS).

Votre propre interface

Appelez l'API avec une clé publique et construisez l'écran de discussion que vous voulez. Exemple Dart ci-dessus.

Serveur MCP : vos assistants IA pilotent allo.

Le Model Context Protocol permet à Claude, Cursor, VS Code ou tout assistant compatible d'utiliser allo. comme un outil : poser une question à l'agent, chercher dans sa base de connaissances, lui apprendre une information, lire les conversations, répondre aux tickets. Même clé secrète que l'API, même quota.

Adresse du serveur : https://www.allo.africa/mcp (Streamable HTTP).

claude mcp add --transport http allo https://www.allo.africa/mcp \
  --header "Authorization: Bearer allo_sk_VOTRE_CLE"

Trois invites prêtes à l'emploi sont aussi proposées par le serveur (commandes /mcp__allo__… dans Claude Code) : integrate_allo_widget (installe l'agent dans le projet ouvert, en détectant le framework), setup_allo_agent (configure l'agent à partir du site de l'entreprise, puis le teste) et weekly_review (bilan de la semaine : questions sans réponse, connaissances à ajouter).

Exemple : ouvrez le projet de votre site dans Cursor ou Claude Code, puis écrivez « Installe l'assistant allo. sur ce site ». L'assistant appelle get_integration_snippet et place le code au bon endroit.

Outils disponibles :

get_integration_snippetCode prêt à coller pour installer l'agent : HTML, React, Next.js, Vue, WordPress, Flutter, iframeLecture
get_agent_settingsLire la configuration de l'agentLecture
update_agent_settingsConfigurer l'agent : présentation, ton, accueil, consignes, contacts, couleurs, voixÉcrit
ask_agentPoser une question à l'agent et recevoir sa réponse (compte comme un message)Lecture
search_knowledgeChercher dans la base de connaissancesLecture
list_knowledge_sourcesLister les sources de connaissancesLecture
add_knowledgeAjouter un site, un texte ou une question-réponseÉcrit
add_knowledge_fileEnvoyer un document : PDF, image, texte, CSV, JSONÉcrit
update_knowledge_sourceRenommer, modifier ou désactiver une sourceÉcrit
resync_knowledge_sourceRelire un site pour reprendre son contenu récentÉcrit
delete_knowledge_sourceSupprimer une sourceÉcrit
list_links / add_link / update_link / delete_linkGérer les liens utiles proposés aux clientsÉcrit
list_offers / create_offer / update_offer / delete_offerOffres du moment : créer, publier, dater, supprimer (Starter et plus)Écrit
add_offer_fileJoindre un document à une offreÉcrit
list_team / add_team_member / update_team_member / remove_team_memberGérer l'équipe de conseillersÉcrit
list_recipients / add_recipient / update_recipient / remove_recipientGérer les adresses alertées pour les ticketsÉcrit
list_conversations / get_conversationLire les conversations des clientsLecture
list_tickets / get_ticketLire les tickets transmis aux conseillersLecture
reply_to_ticket / close_ticket / reopen_ticketRépondre, clore ou rouvrir un ticketÉcrit
get_plansFormules, prix et quotasLecture
start_upgrade / get_payment_statusPayer une formule par Mobile Money et suivre le paiementÉcrit
get_usage / get_agent_infoConsommation du mois et présentation publique de l'agentLecture

Claude.ai, ChatGPT et les connecteurs OAuth

Aucune clé à copier : ajoutez un connecteur personnalisé avec l'adresse https://www.allo.africa/mcp. L'assistant ouvre une page allo. où vous vous connectez (e-mail et mot de passe, ou Google) puis autorisez l'accès à votre entreprise. Vous pouvez retirer cet accès à tout moment, rubrique Développeurs de votre espace.

Pas encore de compte ? Créez-le depuis l'assistant

Ajoutez le serveur d'accueil https://www.allo.africa/mcp/start, sans clé. Il propose get_plans et create_account : votre espace gratuit est créé, avec son adresse, vos identifiants et une clé pour le serveur principal.

Le serveur MCP et l'API REST sont ouverts à toutes les formules, Free comprise.

CRM et automatisations

Avec une clé secrète, branchez allo. à votre CRM (HubSpot, Zoho, Odoo, Salesforce…) ou à Zapier, Make et n8n : récupérez les conversations et les tickets, répondez aux clients depuis votre outil, enrichissez la base de connaissances automatiquement depuis votre catalogue ou votre FAQ. Les notifications en temps réel (webhooks) et le serveur MCP pour les assistants IA arrivent ensuite.

Limites et erreurs

  • Formules : l'API, le serveur MCP et le widget sont ouverts à toutes les formules. Seul le nombre de clés actives change : 1 en Free, 5 en Go, 10 en Starter, illimité en Premium.
  • Quotas : les messages envoyés par l'API comptent dans le quota mensuel. Au-delà : erreur 402 quota_messages.
  • Débit : 240 requêtes par minute et par clé, 30 messages par minute et par utilisateur. Au-delà : 429.
  • Erreurs : JSON { "statusCode": 401, "code": "invalid_api_key", "message": "…" }. 401 clé absente ou invalide, 403 ressource interdite à ce type de clé ou site non autorisé, 404 introuvable, 402 abonnement ou quota.
  • Sécurité : les clés sont stockées sous forme d'empreinte, montrées une seule fois, et révocables à tout moment.

Une question ? Écrivez à allo@soluweb-digital.com.