Documentation Chirps

Chirps est une plateforme de support client propulsée par RAG. Votre assistant lit votre contenu réel avant de répondre - pas d'organigrammes manuels. Les visiteurs discutent sur votre site ; vous gérez tout depuis le tableau de bord sur chirps.cc.

Ce que fait Chirps

• Réponses depuis vos connaissances - exploration de site web, téléversement de PDF, extraits de texte.
• Intégration en quelques minutes - une balise script via embed.js.
• Capture de leads - formulaires dans le chat et calendriers de réservation.
• Alerte votre équipe - WhatsApp, SMS, Telegram, Discord, envoi par e-mail.
• Support vocal - appels vocaux dans le navigateur et numéros de téléphone dédiés optionnels.
• Prise en charge humaine - les agents répondent en direct depuis la boîte de réception si nécessaire.

Pour qui c'est fait

• E-commerce - livraison, retours, questions sur les produits (voir guide Shopify).
• SaaS - intégration et redirection vers la documentation.
• Services locaux - accueil après les heures d'ouverture et rappels.
• Agences - un assistant par site client.

En quoi il diffère des chatbots traditionnels

Plan de la documentation

Ce guide couvre l'ensemble de la plateforme. Commencez par Premiers pas, puis Base de connaissances, Widget, et Dépannage. Aide publique : Support et Blog.

Chirps transforme votre site web et vos documents en un agent de support IA 24h/24. Vous ne construisez pas d'arbres de décision - vous pointez l'assistant vers votre contenu, personnalisez le widget et collez un script sur votre site.

1. Créez votre compte

Allez sur S'inscrire et enregistrez-vous avec email/mot de passe ou Google OAuth. Après confirmation (inscriptions par e-mail), connectez-vous sur Connexion. Vous arrivez sur votre tableau de bord - l'accueil de votre espace de travail.

2. Démarrez l'assistant en 7 étapes

Cliquez sur Nouvel assistant dans la barre latérale ou l'en-tête du tableau de bord. Vous êtes dirigé vers l'assistant de création. La progression s'enregistre automatiquement dans votre navigateur en tant que brouillon.

Étape 1 - À propos de vous

• Nom de l'entreprise (2–100 caractères) - affiché dans l'en-tête du widget.
• URL du site web - utilisée comme source d'exploration par défaut et verrouillage de domaine pour l'intégration.

Étape 2 - Apprentissage

Choisissez comment l'assistant apprend :

• URL du site web - explore les pages publiques de votre domaine.
• Document - téléversez des PDF, DOCX, TXT, MD ou images.
• Les deux - exploration plus fichiers.
• Aucun - passer pour l'instant ; ajouter des connaissances plus tard dans l'onglet Connaissances.

Étape 3 - Langue

• Langue principale - langue de réponse par défaut.
• Multilingue - l'assistant reconnaît et répond dans la langue du visiteur lorsqu'activé.

Étape 4 - Personnalité

Choisissez un ton prédéfini : Professionnel, Amical, Concis, Empathique, Enthousiaste, ou Personnalisé avec votre propre description (max 2 000 caractères).

Étape 5 - Assistance humaine

• E-mail de support - où les escalades humaines peuvent être acheminées.
• Pages max - combien d'URLs explorer (curseur 1–50, plafonné par votre forfait).
• Profondeur max - combien de niveaux de liens suivre (1–20, plafonné par forfait).

Étape 6 - Directives

Instructions supplémentaires optionnelles (jusqu'à 10 000 caractères). Exemples : limites de la politique de remboursement, mentions de concurrents, règles de ton.

Étape 7 - Révision et lancement

Vérifiez vos choix et cliquez sur Lancer l'assistant. Une superposition de configuration s'exécute pendant que Chirps explore, indexe et génère votre invite système.

3. États du pipeline de configuration

1. Plantation des graines… - enregistrement de l'assistant créé.
2. Apprentissage de votre entreprise… - l'explorateur récupère les pages et documents.
3. Synchronisation des connaissances… - embeddings et génération d'invite.
4. Votre assistant est prêt ! - vous pouvez ouvrir le tableau de bord de l'assistant.

Durée typique : 15–30 secondes. En cas d'échec, vous pouvez réessayer ou passer au tableau de bord et corriger les connaissances manuellement.

4. Copiez votre code d'intégration

Ouvrez votre assistant → onglet Intégration (`?tab=integration`). Copiez l'extrait :

<script>
  window.chirpsConfig = { assistantId: "VOTRE_ID_ASSISTANT" };
</script>
<script src="https://chirps.cc/embed.js" async></script>

Collez avant `</body>` sur votre site (ou utilisez les guides de plateforme sous Intégration). Voir Intégrations pour WordPress, Shopify, Webflow et plus.

5. Liste de vérification post-lancement

1. Apparence - couleurs de marque, message de bienvenue, suggestions de départ, mode sombre si nécessaire.
2. Connaissances - vérifiez les pages explorées ; ajoutez les URLs ou PDF manquants ; cliquez sur Former le moteur IA.
3. Notifications - connectez WhatsApp, SMS, Telegram ou e-mail pour les alertes de leads.
4. Paramètres - définissez le domaine autorisé ; désactivez le Mode développeur avant la production.
5. Posez 5 vraies questions de clients sur votre site en ligne et corrigez les lacunes dans les connaissances.

Après la connexion sur chirps.cc vous voyez une barre latérale persistante, un sélecteur d'espace de travail et une cloche de notifications. Ce à quoi vous pouvez accéder dépend de votre rôle - les propriétaires et administrateurs voient tout ; les collaborateurs ne voient que les sections autorisées.

Navigation de la barre latérale

Accueil de l'espace de travail

Route : /dashboard

Cartes de statistiques

• Total des assistants - agents déployés dans cet espace de travail.
• Total des sessions - fils de conversation uniques des visiteurs.
• Taux de satisfaction IA - CSAT des enquêtes pouces levé/baissé.
• Échanges de messages - nombre total de messages à vie.
• Messages de l'assistant (Facturés) - réponses IA ce mois-ci vers le plafond de votre forfait.

Liste des agents déployés

Chaque carte affiche le nom de l'entreprise, le favicon, le statut (En ligne, En pause ou états de configuration), et des liens vers votre page de détail de l'assistant.

Sélecteur d'espace de travail

Basculez entre votre espace de travail personnel et les espaces d'équipe auxquels vous appartenez. Votre espace de travail personnel affiche un badge Par défaut. Les limites de facturation s'appliquent toujours au propriétaire de l'espace de travail, pas au membre connecté.

Cloche de notifications

Les invitations d'équipe et les alertes apparaissent ici. Acceptez les invitations d'espace de travail depuis la cloche - il n'y a pas de page d'invitation séparée.

Centre de commande de l'assistant

Chaque assistant s'ouvre sur `/dashboard/assistants/[id]` avec ces onglets (requête `?tab=`) :

• overview - métriques et graphique de performance
• conversations - boîte de réception pour cet assistant
• appearance - personnalisateur de widget
• artifacts - formulaires, réservation, cartes, CSAT
• notifications - canaux de distribution
• integration - code d'intégration et guides de plateforme
• knowledge - exploration, formation, récolte
• phone - numéro vocal et modules de distribution
• settings - statut, verrouillage de domaine, limites de débit, RGPD, suppression

Jusqu'à ce que la configuration soit prête, vous ne voyez que l'écran de progression de la configuration - pas les onglets. Voir Onglets de l'assistant pour chaque champ.

Ouvrez n'importe quel assistant depuis votre tableau de bord. Utilisez la barre d'onglets pour configurer le comportement. Cliquez sur Publier les modifications dans Apparence après les éditions.

Onglet Vue d'ensemble

Route : `?tab=overview`

• Cartes KPI : sessions, CSAT, messages IA facturés, messages combinés IA+agent, messages totaux.
• Graphique Tendances de performance avec filtre 7 / 14 / 30 / 90 jours.
• Barre de progression Plafond mensuel pour les interactions IA facturées.
• Répartition des réponses : Géré par IA, Assisté par humain, Interactions utilisateur.
• Résumé Configuration du moteur : personnalité, langue, source de connaissances.

Onglet Apparence

Route : `?tab=appearance` - aperçu du widget en direct à droite.

Texte & contenu

Thème & mise en page

• Thème du widget - Clair ou Sombre.
• Style de bulle - circle, bar, drawer (standard ou brandé avec logo).
• Couleur principale - sélecteur de couleur + hex.
• Position - bottom-right, bottom-left, top-right, top-left.
• Visibilité de page - toutes les pages, seulement ces chemins ou toutes sauf (supporte les wildcards `/*`).

Bascules de fonctionnalités

Paramètres vocaux

Quand la voix est activée : choisissez Modèle vocal IA et Voix physique (30+ options avec aperçu).

Onglet Artefacts

Route : `?tab=artifacts` - guide complet : Artefacts & Formulaires

• Formulaires de lead / Contact - champs personnalisés, assistants multi-étapes.
• Réservation & Planification - OAuth Google Calendar, services, créneaux horaires.
• Cartes de produit / service - liens CTA dans le chat.
• Sondage CSAT - pouce haut/bas avec règles de déclenchement.
• Artefacts personnalisés - schéma JSON (Starter+ / Pro tier 5+).

Onglet Notifications

Route : `?tab=notifications` - voir Notifications & Téléphone

Canaux : WhatsApp, SMS, Telegram, Discord, Email, Webhook (Entreprise). Variables de template et bouton Test par canal.

Onglet Intégration

Route : `?tab=integration`

Copiez l'extrait d'intégration et suivez les étapes de la plateforme. Tous les guides : Intégrations.

Onglet Connaissances

Route : `?tab=knowledge` - chapitre Base de connaissances.

Onglet Communication

Route : `?tab=phone` - achetez des numéros sur Communications.

Onglet Paramètres

Route : `?tab=settings`

Général

Bascule Statut de l'assistant - En direct ou Inactif.

Sécurité & accès

• Domaine autorisé - le widget ne se charge que sur l'hôte correspondant (sous-domaines autorisés).
• Mode développeur - contourner le verrouillage de domaine pour localhost/staging.

Limitation de débit

Plafond par visiteur : par défaut 30 messages par 60 minutes. Ajustable 5–500 messages, fenêtre de 1–1440 minutes.

Confidentialité & RGPD

• Exiger le consentement pour discuter - écran de consentement avant l'ouverture du chat.
• Masquage des données PII - rédaction côté serveur des emails, téléphones, cartes.

Zone de danger

Supprimer l'assistant - tapez le nom exact de l'entreprise pour confirmer.

Chirps utilise RAG (Retrieval-Augmented Generation) : chaque réponse commence par une recherche dans votre contenu indexé. Si le fait n'est pas dans votre base de connaissances, l'assistant doit escalader - pas deviner.

Ouvrir l'onglet Connaissances

Dans le tableau de bord de votre assistant : Connaissances (`?tab=knowledge`). La barre latérale gauche affiche votre Plan de connaissances - blocs, insights et statut de synchronisation.

Ajouter un bloc de connaissances

Cliquez sur Ajouter → Ajouter un bloc de connaissances :

Ajouter, Re-explorer & Former (URLs) ou Ajouter & Former (extraits/fichiers) enregistre et indexe le contenu.

Limites d'exploration

• Max de pages - défini à la création (1–50) ; limité par votre forfait.
• Profondeur max - combien de niveaux de liens suivre (1–20).
• L'exploration initiale de l'assistant ne consomme pas les crédits de re-exploration/formation.
• La Re-exploration manuelle par nœud URL consomme le quota mensuel de re-exploration.

Actions du moteur

Former le moteur IA

Reconstruit les embeddings depuis tous les blocs actifs. Consomme le quota de formation. Lancez après édition de contenu ou ajout de blocs.

Re-explorer & Former

Re-récupère tous les nœuds URL, puis forme. Utilisez après une mise à jour globale des tarifs ou politiques du site.

Récolter des insights depuis les chats

Scanne les conversations pour les lacunes de connaissances. Jusqu'à 3 insights par exécution. Revoyez dans la barre latérale → Valider les bons insights en faits permanents.

Sous-onglets de l'éditeur

• Raffinerie - éditer le texte nettoyé (`refined_content`), activer/désactiver, re-exploration par nœud.
• Identité - nom de l'entreprise, description, langue, ton, email de support, directives.
• Tête IA - prompt système brut (avancé).
• Visualisation - graphe de connaissances Mermaid.

Corriger les réponses erronées ou "Je ne sais pas"

1. Vérifiez si la page a été explorée (liste de la barre latérale Connaissances).
2. Lancez Re-explorer sur cette URL ou téléversez un PDF avec l'info manquante.
3. Cliquez sur Former le moteur IA.
4. Testez la même question dans le widget en direct.
5. Si toujours bloqué, ajoutez un court paragraphe FAQ sur votre site public et re-explorez.

Limite de quota atteinte ? Passez à un forfait supérieur dans Facturation ou attendez la réinitialisation mensuelle UTC.

Les visiteurs voient une bulle de chat sur votre site. Quand ils l'ouvrent, ils obtiennent un panneau brandé propulsé par embed.js - isolé dans Shadow DOM pour que le CSS de votre site ne casse pas le widget.

Styles du lanceur (bulle)

Configurez dans Apparence (`?tab=appearance`). Position : bottom-right, bottom-left, top-right ou top-left.

Fonctionnalités du chat

• Messages - formatage markdown-lite, aperçus de liens, pilules de citation de sources.
• Suggestions de démarrage - jusqu'à 3 pilules de bienvenue ; appuyez pour envoyer automatiquement.
• Suggestions en ligne - pilules de réponse rapide générées par IA sous les réponses.
• Répondre au message - citez une réponse de l'assistant et suivez.
• Bulle de réflexion - texte scintillant pendant le traitement IA ; se met à jour avec des labels de statut.
• Badge non lus - compteur sur la bulle quand le chat est fermé ; aperçu toast + son optionnel.

Barre de saisie

• Texte - jusqu'à 2 000 caractères ; Entrée pour envoyer.
• Appel vocal - bouton de forme d'onde quand la saisie est vide (si voix activée).
• Dictée - micro pour la reconnaissance vocale (Speech Recognition du navigateur).
• Joindre (+) - sélecteur de fichier ou capture d'écran (téléversement de fichier Pro).

Pièces jointes de fichiers (Pro)

PDF, TXT, MD, DOCX, PNG, JPG, WEBP - max 5 Mo. Les images s'affichent en aperçu dans la bulle utilisateur.

Mode Copilote (Bêta)

Le Mode Copilote transforme votre site web en un canvas interactif. Quand un utilisateur active le Copilote, l'IA devient consciente de l'écran, gagnant la capacité d'inspecter la vue actuelle de l'utilisateur, de sélectionner des éléments et de surligner des réponses directement sur la page.

• Conscience de l'écran - L'IA lit exactement ce que l'utilisateur regarde sans nécessiter de copier/coller de texte ou d'expliquer le contexte.
• Mode crayon & Sélection - Les utilisateurs peuvent cliquer sur l'icône Crayon pour sélectionner visuellement des éléments sur la page, pointer vers des paragraphes spécifiques ou surligner des boutons, donnant à l'IA un contexte précis.
• Navigation visuelle - L'IA peut surligner des sections ou éléments spécifiques sur votre site pour attirer l'attention de l'utilisateur.
• Activation - Les visiteurs peuvent déclencher le Mode Copilote depuis le menu d'attachement (+), la superposition d'appel, ou en appuyant sur `Échap`. (Note : cette fonctionnalité nécessite un forfait Pro ou Entreprise).

Appels vocaux

Initié par le visiteur

Appuyez sur le bouton vocal → superposition plein écran : minuteur, visualiseur, muet, minimiser, terminer l'appel. L'IA salue à la connexion. Les artefacts (formulaires/réservation) peuvent apparaître pendant les appels.

Initié par l'IA

Superposition d'appel entrant avec sonnerie - le visiteur Accepte ou Refuse.

Consentement RGPD

Quand activé dans les Paramètres de l'assistant, les visiteurs voient un écran Avis de confidentialité avec J'accepte & Continuer avant l'ouverture du chat. Associez avec une URL de politique de confidentialité dans Apparence. Voir Politique de confidentialité pour votre propre politique de site.

Mode sombre

Définissez Thème du widget sur Sombre dans Apparence. La bulle de réflexion, le menu d'attachement, l'écran RGPD et la zone de messages suivent la palette sombre.

Agent humain (vue visiteur)

Quand un agent prend le relais depuis la boîte de réception du tableau de bord, l'en-tête affiche le nom et l'avatar de l'agent. Il n'y a pas de bouton "Parler à un humain" - l'escalade est déclenchée par l'IA ou votre équipe.

Mobile

• ≤480px : le chat remplit la fenêtre d'affichage.
• Mode étendu sur tablette : panneau quasi plein écran.
• Mode tiroir : feuille inférieure pleine largeur sur petits écrans.

Les artefacts sont des blocs UI interactifs que l'IA montre pendant la conversation - formulaires que les visiteurs remplissent, calendriers pour réserver ou cartes sur lesquelles ils cliquent. Configurez-les dans Artefacts (`?tab=artifacts`).

Formulaires de lead / Contact

• Champs par défaut : Nom complet, Email, Téléphone, Détails.
• Ajoutez des champs personnalisés : text, email, tel, textarea, select, radio, checkbox, slider, date, url, location (sélecteur de carte).
• Assistant multi-étapes quand il y a plus d'un champ.
• Soumission → enregistré dans Leads + notifications de dispatch.

Règles de déclenchement

Définissez quand l'IA doit montrer le formulaire (ex. "quand l'utilisateur demande un devis" ou "après une question sur les tarifs").

Réservation & planification

1. Connectez Google Calendar depuis l'onglet Artefacts (OAuth retourne via callback calendrier).
2. Ajoutez des services avec durée, catégorie et routage (virtuel / physique / téléphone).
3. Définissez les heures d'ouverture, temps tampon, dates bloquées et fuseau horaire.
4. Le visiteur choisit le service → date → créneau horaire (en direct depuis l'API calendrier) → formulaire d'admission → confirmer.

Le succès affiche le texte de confirmation et déclenche le dispatch booking_confirmed vers vos canaux de notification.

Cartes de produit / service

Cartes uniques ou carrousel avec titre, description, bannière en dégradé et lien CTA. Utilisez pour les recommandations de produits ou les points forts d'études de cas.

Sondage CSAT

Pouce haut / bas après les interactions de support. Alimente les métriques de satisfaction sur l'onglet Vue d'ensemble de l'assistant et Analyses.

Artefacts personnalisés

Éditeur de schéma JSON pour des composants sur mesure. Nécessite Starter+ ou Pro tier 5+ (`custom_artifacts`). Le widget affiche un placeholder et déclenche un événement `chirps:artifact` pour un rendu personnalisé côté page hôte.

Configurez les canaux de notification par assistant dans Notifications (`?tab=notifications`). Achetez des numéros de téléphone pour tout l'espace de travail sur Communications.

Événements de dispatch

• Lead capturé - formulaire de contact ou lead hérité soumis.
• Réservation confirmée - réservation de calendrier terminée.
• Transfert agent - prise de contrôle humaine (quand configuré).

Référence des canaux

Variables de template

Utilisez dans les templates HTML/texte : `{{form_data}}`, `{{form_data_html}}`, `{{timestamp}}`, `{{lead_location}}`, `{{dashboard_url}}`, `{{booking_routing}}`, `{{notes}}`.

Cliquez sur Test sur n'importe quel canal pour envoyer un échantillon sans attendre un événement en direct.

Acheter un numéro de téléphone

1. Ouvrez Communications ou l'onglet Téléphone de l'assistant.
2. Choisissez le pays (US, CA, GB, AU, IE, SE, FI, EE, LT, PL) et le code régional optionnel.
3. Sélectionnez un numéro dans les résultats de recherche.
4. Définissez le curseur de minutes vocales (60–5 000) et les bundles SMS/WhatsApp optionnels.
5. Assignez à un assistant → S'abonner & Réclamer via Stripe Checkout.

Utilisation vocale

• Les appels entrants sont répondus par l'IA utilisant les mêmes connaissances que le chat.
• Les transcriptions sont enregistrées dans Conversations.
• Les minutes sont suivies par rapport au bundle inclus ; dépassement facturé par minute.
• Rappel IA depuis la boîte de réception peut passer des appels sortants vers les visiteurs.

Add-on dispatch autonome

Bundles mensuels SMS/WhatsApp sans acheter un numéro vocal - même flux de paiement sous l'onglet Dispatch autonome.

Gérez les abonnements sur Facturation → Gérer la facturation.

La boîte de réception Conversations est votre file d'attente de support en direct. Leads stocke les soumissions de formulaires. Analyses affiche les tendances de l'espace de travail.

Boîte de réception Conversations

Filtres

• Rechercher par ID de session.
• Statut : Tous, En direct (agent actif), En ligne (activité <2 min), Hors ligne.
• Type : Réservation, Formulaire.
• Assistant menu déroulant - global à l'espace de travail ou par onglet d'assistant.
• Artefact : Réservation, Lead, Appel.

20 conversations par page. Mises à jour en temps réel quand de nouveaux fils démarrent.

Détail de la conversation

• Fil de messages complet (rôles utilisateur, IA, agent).
• Bascule Agent actif - répondre en tant qu'humain ; le visiteur voit votre nom/avatar.
• Télécharger la transcription (.txt).
• Rappel IA - entrez la raison → appel vocal sortant.
• Artefacts liés et données de lead.

Leads

Route : /dashboard/leads

• Filtrer : Nouveau, Contacté, Archivé.
• Filtrer par assistant.
• Ouvrir la feuille de détails → mettre à jour le statut → voir la conversation liée.
• Exporter CSV pour l'import CRM.

Analyses

Route : /dashboard/analytics

• Cartes KPI, graphiques, carte de chaleur horaire.
• Top assistants par volume de sessions.
• Répartition par pays et statistiques d'implication des agents.
• Plages de dates : 7J, 14J, 30J, 90J.

Les métriques par assistant apparaissent aussi sur l'onglet Vue d'ensemble de l'assistant (`?tab=overview`).

Retours CSAT

Les pouces haut/bas des artefacts CSAT alimentent le % de satisfaction sur Vue d'ensemble et Analyses.

Les forfaits et l'utilisation se trouvent sur Facturation. La gestion d'équipe sur Équipes de l'espace de travail. Les limites sont toujours facturées au propriétaire de l'espace de travail.

Niveaux de forfait (page tarification)

*Les limites appliquées proviennent de la ligne de forfait de la base de données. Voir la comparaison complète sur Tarification.

Compteurs d'utilisation

• Messages assistant - réponses IA facturées par mois.
• Quota connaissances - récolte + re-exploration + formation combinés.
• Quota de dispatch - envois SMS + WhatsApp + email.
• Assistants créés - assistants prêts simultanés.
• Places collaborateurs - membres invités non propriétaires.
• Espaces de travail rejoints - espaces de travail externes que vous pouvez rejoindre.

Barrières de fonctionnalités

Inviter des membres de l'équipe

Administrateurs : Équipes de l'espace de travail → entrez l'email → définissez les Permissions → Envoyer l'invitation.

Catégories de permissions

• Espace de travail : voir conversations, leads, facturation, créer/gérer assistants, téléphones, notifications.
• Accès assistant : tous les assistants ou des spécifiques.
• Onglets : connaissances, paramètres, analyses, embed, personnaliser, conversations par membre.

L'invité accepte via la cloche de notification sur son tableau de bord.

Problèmes de paiement

Rétrograder / annuler

L'annulation ou la rétrogradation exécute scrubToPlanLimits : branding ré-activé, téléversement de fichier/voix peut se désactiver, assistants en excès désactivés.

Questions ? Ouvrir un ticket de facturation ou envoyez un email à [email protected] via Support.

Toutes les plateformes utilisent le même code d'intégration. Les guides étape par étape pour chaque constructeur sont disponibles sur chirps.cc sous Intégrations.

<script>
  window.chirpsConfig = { assistantId: "VOTRE_ID_ASSISTANT" };
</script>
<script src="https://chirps.cc/embed.js" async></script>

Remplacez `VOTRE_ID_ASSISTANT` par l'ID de l'onglet Intégration de votre assistant (`?tab=integration`).

Guides de plateforme

Pages d'outils no-code & dev

• Bolt.new
• Lovable
• v0
• Cursor
• VS Code
• Windsurf
• Claude Code
• GitHub Copilot
• Xcode

Verrouillage de domaine & staging

• Le widget se charge uniquement sur les domaines correspondant à votre domaine autorisé (onglet Paramètres).
• Activez le Mode développeur pour localhost et les URLs d'aperçu.
• Désactivez le Mode développeur avant le lancement en production.

Tester avant le lancement

1. Publiez votre site avec l'extrait d'intégration.
2. Ouvrez l'URL en direct dans une fenêtre incognito.
3. Posez des questions sur : tarification, livraison/retours, contact et une question spécifique sur un produit.
4. Soumettez un formulaire de lead de test et confirmez que l'alerte de dispatch arrive.
5. Désactivez le Mode développeur s'il était activé.

Nouveau sur Chirps ? Commencez par Démarrage ou Inscrivez-vous.

Le widget est un client navigateur qui communique avec les APIs chirps.cc. Vous n'avez pas besoin de clés API pour l'intégration - seulement votre `assistantId` public.

Séquence de chargement

1. Le site charge `https://chirps.cc/embed.js` avec `window.chirpsConfig.assistantId`.
2. embed.js récupère `GET /api/assistants/{id}/widget-config`.
3. Vérification du verrouillage de domaine (403 si origine ≠ domaine autorisé, sauf si Mode développeur).
4. Charge `widget.js` et monte l'UI de chat Shadow DOM.

Endpoints côté visiteur

Sécurité

• Verrouillage de domaine - l'hôte `business_url` doit correspondre à l'origine de la page ; sous-domaines autorisés.
• Mode développeur - contourne le verrouillage pour le staging (désactiver en production).
• Limitation de débit - plafond de messages par visiteur (onglet Paramètres, par défaut 30/heure).
• Masquage PII - rédaction côté serveur optionnelle quand activée.

APIs réservées au tableau de bord

Routes de session authentifiées (pas pour l'intégration) : CRUD assistant, former, récolter, PATCH widget-config, facturation, invitation équipe, canaux de notification. Géré uniquement depuis le tableau de bord après connexion.

Webhooks (serveur à serveur)

• Stripe → `POST /api/billing/webhook`
• Twilio → `POST /api/twilio/*` pour voix et SMS
• Votre serveur ← Canal de dispatch Webhook Entreprise sur événements lead/réservation

Documentation produit complète : Documentation · Confidentialité · Conditions.

La plupart des problèmes tombent dans quatre catégories : embed/domaine, lacunes de connaissances, limites de forfait ou config de dispatch. Toujours bloqué ? Contactez le support ou envoyez un email via la page Support.

Widget & intégration

Réponses & connaissances

Facturation & limites

Dispatch & téléphone

Équipe & accès

Réservation & calendrier