La liste des agents email. Chaque agent affiche son nom, sa date de création et un avertissement en orange tant qu'aucune boîte n'est connectée.
Un court assistant de configuration s'ouvre et t'accompagne à travers les mêmes réglages que ceux décrits dans les prochaines étapes de ce guide : nom, instructions, catégories, règles d'automatisation et boîte de réception. Ne t'inquiète pas de tout faire parfaitement du premier coup : toutes les étapes sauf le nom peuvent être sautées, et tu peux ensuite modifier n'importe quoi depuis les onglets de configuration de l'agent. Donne-lui un nom qui te dit d'un coup d'œil de quoi il s'occupe, par exemple « Service client » ou « Boîte des ventes ». Tu as jusqu'à 50 caractères, et ce nom apparaît partout où l'agent apparaît, alors mieux vaut clair qu'astucieux. Tu peux le changer quand tu veux depuis le champ de texte en haut de l'écran de l'agent. Sous le nom, dans la liste, tu verras **Aucune adresse email assignée** en orange. C'est normal : cela signifie seulement qu'aucune boîte n'est encore connectée. Tu régleras ça à l'étape 4. Chaque ligne de la liste a aussi un menu **⋮** avec trois actions : **Copier l'ID** copie l'identifiant unique de l'agent, **Modifier** ouvre sa configuration et **Supprimer** efface l'agent de façon permanente après une confirmation. Supprimer un agent n'efface que sa configuration et sa connexion : ton compte email et les messages qu'il contient ne sont pas touchés. Une fois l'agent créé, sa configuration s'organise en quatre onglets : **Agent**, **Catégories**, **Boîte de réception** et **Avancé**. Les prochaines étapes les parcourent dans cet ordre. ## Étape 2 — Explique à l'agent comment se comporter Ouvre l'onglet **Agent**. C'est ici que tu définis la personnalité et le jugement de l'agent. ### Prompt de conversation Le **prompt de conversation** est un cadre où tu écris, en langage normal, comment l'agent doit gérer les emails. Il n'y a aucune syntaxe spéciale : tu l'écris comme tu expliquerais le travail à un nouveau collègue le premier jour. Un exemple court : > Réponds de façon professionnelle et transmets les questions de facturation à une personne. Plus tu es précis, plus le résultat sera prévisible. Une version plus utile pour un cabinet dentaire serait : « Tu réponds au nom du Cabinet Dentaire Démo. Sois chaleureux et bref. Réponds aux questions sur les horaires, l'adresse et les prix. Si quelqu'un demande à déplacer un rendez-vous, dis-lui qu'une personne de l'équipe lui écrira aujourd'hui même et ne promets pas d'heure précise. » Le compteur dans le coin inférieur droit du cadre t'indique combien d'espace tu as utilisé sur les 4000 caractères disponibles. C'est largement suffisant pour des instructions très détaillées. Tout changement enregistré ici s'applique immédiatement aux nouveaux emails entrants. > **Astuce :** Écris aussi ce que l'agent ne doit **pas** faire, pas seulement ce qu'il doit faire. Des phrases comme « ne confirme jamais de rendez-vous », « ne promets jamais de remboursements » ou « ne parle jamais de prix par email » t'évitent presque toutes les surprises. ### Intelligence IA (LLM) À droite de ce même onglet, tu verras **Intelligence IA (LLM)**. Un **LLM** (grand modèle de langage) est le moteur qui lit et écrit du texte : c'est la partie qui comprend vraiment l'email et rédige la réponse. Clique sur la carte du modèle pour ouvrir un panneau latéral avec les options disponibles. À côté de chaque modèle, tu verras une étiquette qui indique son niveau de raisonnement, c'est-à-dire combien le modèle « réfléchit » avant d'écrire. Plus de raisonnement apporte plus de nuances, mais aussi plus de temps et plus de coût par réponse. | Modèle | Niveau de raisonnement | Pour quoi il convient | | ------------- | ---------------------- | ----------------------------------------------------------------------------- | | GPT 5.4 Mini | Faible | L'option par défaut, équilibrée entre qualité, vitesse et coût | | Claude Sonnet | Moyen | Les réponses où le ton compte le plus, avec une voix soignée et naturelle | | GPT 5.4 Nano | Faible | De gros volumes d'emails simples, où la vitesse et le coût comptent davantage | | GPT 4.1 Mini | Faible | Une option stable et équilibrée pour un trafic élevé et constant | Dans ce même panneau, tu trouveras la **température**, un curseur de 0 à 1 qui démarre à 0,7. Elle règle à quel point les réponses de l'agent sont créatives ou prévisibles. Les valeurs basses maintiennent une rédaction constante et répétable, utile quand les réponses doivent suivre un modèle. Les valeurs hautes rendent la rédaction plus variée et naturelle, en échange de plus de différences entre des messages similaires. > **Si c'est ta première fois :** Tu n'as rien à toucher ici. Le modèle et la température par défaut fonctionnent bien pour la plupart des boîtes. Reviens plus tard : si les réponses sonnent robotiques, essaie Claude Sonnet ou monte un peu la température ; si elles varient trop, baisse-la. ## Étape 3 — Organise tes emails avec des catégories Ouvre l'onglet **Catégories**. Les catégories sont des étiquettes facultatives qui aident l'agent à comprendre à quel type de message il a affaire : factures, réclamations, demandes de rendez-vous, etc. Chaque catégorie existante apparaît comme une carte avec son étiquette, sa description et une icône crayon pour la modifier ou corbeille pour la supprimer. Ça vaut la peine de les configurer parce qu'elles te permettent de traiter chaque type d'email différemment. Tu veux peut-être que l'agent réponde tout seul à une question simple sur les horaires, mais qu'il se limite à préparer un brouillon quand le message parle d'argent. Clique sur **Ajouter une catégorie**. Une fenêtre s'ouvre avec ces champs : | Champ | Ce qu'il fait | Exemple | | ---------------------- | ---------------------------------------------------------- | ----------------------------------- | | Nom de la catégorie | L'étiquette courte que tu verras sur chaque email | Facturation | | Description | Indique à l'agent quand utiliser cette catégorie | Factures, paiements, remboursements | | Couleur de l'étiquette | La couleur de l'étiquette, pour la repérer d'un coup d'œil | Rose | Tu peux choisir une des couleurs prédéfinies ou créer la tienne avec l'échantillon **+**. En dessous, il y a deux interrupteurs : * **Générer un brouillon de réponse pour cette catégorie** : activé par défaut. L'agent prépare la réponse et te la laisse prête à relire avant qu'elle parte. * **Réponse automatique pour cette catégorie** : désactivé par défaut. L'agent envoie la réponse lui-même, sans relecture. Si tu désactives les deux, l'agent continue d'étiqueter le message avec la catégorie mais n'écrit aucune réponse. C'est utile pour les emails que tu veux toujours faire gérer par une personne depuis le début, comme les réclamations ou les questions juridiques. > **Erreur fréquente :** Écrire une description trop vague, du genre « trucs importants ». L'agent utilise ce texte pour décider quels emails entrent ici, alors décris le contenu réel : « messages qui demandent une facture, un remboursement ou un changement de moyen de paiement ». Si tu vois que des emails tombent dans la mauvaise catégorie, affiner la description est en général la solution la plus rapide. > **Important :** Commence avec **Générer un brouillon de réponse** activé et **Réponse automatique** désactivé. Lis les brouillons pendant quelques jours. Quand tu auras vérifié que l'agent trouve le bon ton et les bonnes informations, active la réponse automatique dans les catégories où une erreur n'aurait pas de conséquences. ## Étape 4 — Connecte la boîte de réception Ouvre l'onglet **Boîte de réception**. C'est ici que tu relies le compte email réel dont l'agent va s'occuper. Tant que tu ne le fais pas, l'agent est configuré mais à l'arrêt. Tu as trois options : * **Gmail** : connecte ton compte Google. Tu approuves la connexion sur l'écran d'autorisation habituel de Google, sans rien configurer à la main. * **Outlook** : connecte Microsoft 365, de la même façon que Gmail. * **Autre email (IMAP et SMTP)** : connecte n'importe quel autre fournisseur. **IMAP** est le standard qui permet à l'agent de lire les emails de ta boîte, et **SMTP** est celui qui lui permet d'envoyer les réponses. Ton fournisseur publie ces deux informations dans ses pages d'aide. Si tu choisis l'option manuelle, le formulaire te demande : | Champ | Quoi renseigner | | ------------------------- | ------------------------------------------------------------------------------------------------------ | | Adresse email | La boîte depuis laquelle l'agent lira et enverra | | Mot de passe | Ton mot de passe ou, mieux, un mot de passe d'application si ton compte a la validation en deux étapes | | Serveur IMAP | Le serveur de lecture, quelque chose comme imap.tonfournisseur.com | | Port IMAP | En général 993, que le formulaire suggère par défaut | | Jours d'emails à importer | Jusqu'où l'agent regarde en arrière à la première connexion, de 1 à 45 jours | | Serveur SMTP | Le serveur d'envoi, quelque chose comme smtp.tonfournisseur.com | | Port SMTP | En général 587, que le formulaire suggère par défaut | Sous les options, l'écran te rappelle que tes identifiants sont chiffrés et conservés en toute sécurité. > **Note :** Tu peux sauter cette étape et connecter la boîte plus tard. Tout ce que tu as configuré aux étapes précédentes reste enregistré. Souviens-toi cependant que l'agent ne traitera absolument rien tant qu'aucune boîte ne sera reliée. ## Étape 5 — Ajuste le comportement (facultatif) Ouvre l'onglet **Avancé**. Tout ce qui se trouve ici est facultatif, et les deux règles démarrent désactivées. Si c'est ton premier agent, tu peux sauter tranquillement à l'étape 6 et revenir un autre jour. ### Règles d'automatisation **Répondre uniquement à un expéditeur spécifique.** Quand tu l'actives et que tu écris une adresse dans **Adresse email de l'expéditeur**, l'agent ne traite et ne répond qu'aux messages qui arrivent de cette adresse. Tous les autres expéditeurs sont complètement ignorés, et les catégories deviennent facultatives. C'est parfait pour des automatisations étroites et à but unique — toujours répondre à un système automatique ou à un contact précis — et c'est aussi la façon la plus sûre de tester un agent dans une boîte réelle : pointe-le vers ta propre adresse et observe ce qu'il fait, sans toucher aucun client. **Copier les réponses automatiques.** Envoie une copie de chaque réponse automatique à une adresse supplémentaire, que tu écris dans **Email du destinataire en copie**. Dans **Type d'envoi**, tu choisis comment voyage cette copie : * **CC (visible)** : la personne qui reçoit la réponse voit cette adresse dans la ligne de copie. * **CCI (masquée)** : la copie est envoyée en silence et le destinataire ne voit rien. C'est pratique quand un responsable veut suivre de près ce que l'agent envoie. > **Astuce :** Si tu actives la réponse automatique dans une catégorie, active aussi la copie, au moins le temps de prendre confiance dans ce que l'agent écrit. > **Avertissement :** Si la copie va à un collègue interne, choisis **CCI (masquée)**. Avec **CC (visible)**, ton client voit l'email de ton collègue dans chaque message. ### Priorité des agents Quand plusieurs agents partagent la même boîte, le premier agent qui correspond à un email est celui qui s'en occupe : le message ne passe pas aux autres. Cette section te permet de réordonner les agents avec des flèches haut et bas. Classe-les du plus spécifique au plus général : un agent limité à un seul expéditeur devrait être au-dessus d'un agent généraliste de support, pour que l'agent fourre-tout ne s'empare pas de tous les messages. Tu ne pourras changer l'ordre que lorsqu'une boîte sera connectée. D'ici là, l'écran t'indique d'en connecter une dans l'onglet **Boîte de réception**. ## Étape 6 — Enregistre tes modifications Quand tu as des modifications non enregistrées, une barre apparaît en bas de l'écran avec deux boutons : **Annuler**, qui défait tout ce que tu viens de changer, et **Enregistrer**, qui le stocke. > **Important :** Ne quitte pas l'écran tant que cette barre est visible. Si tu pars sans cliquer sur **Enregistrer**, tu perds tes modifications. ## La section Email : lis et réponds en un seul endroit Ouvre **Email** dans la barre latérale gauche. C'est la boîte unifiée : ici apparaissent les messages traités par tes agents, de toutes les boîtes connectées, avec la catégorie reçue par chacun. C'est aussi là que tu relis, modifies et envoies les brouillons préparés par tes agents. Si tu n'as encore connecté aucune boîte, l'écran t'explique exactement ce qui manque et comment le résoudre en trois étapes : ouvre **Agents email** et sélectionne un agent, connecte la boîte dans l'onglet **Boîte de réception** avec Google, avec Microsoft ou via IMAP, et reviens ici pour lire et répondre aux messages. Les deux boutons de cet écran, **Aller aux Agents email** et **Créer un agent email**, t'y emmènent directement.La section Email avant de connecter la moindre boîte. L'écran lui-même te guide à travers les trois étapes qui restent.
Quand une boîte sera connectée, les messages entrants apparaîtront ici quelques minutes après leur arrivée, avec les brouillons et réponses préparés par ton agent. ## La section Outils : donne des superpouvoirs à tes agents Ouvre **Outils** dans la barre latérale gauche. Ici, tu connectes des services externes qui élargissent ce que tes agents peuvent faire avec chaque email, en leur donnant accès à des données en direct qui ne se trouvent pas dans la conversation elle-même. ### Amazon Seller API Avec cette intégration connectée, quand l'email d'un client contient un numéro de commande Amazon, l'agent consulte automatiquement les détails de la commande et peut les utiliser dans sa réponse, au lieu de demander au client des informations que le système a déjà.La section Outils avec l'intégration Amazon Seller API connectée. La carte affiche les données du compte et l'état de la connexion.
Quand l'intégration est active, sa carte affiche un badge vert **Connecté** avec les détails de la connexion : le nom du compte vendeur, l'identifiant du partenaire de vente, la région, la place de marché et la date de connexion. Depuis la même carte, tu peux écrire un numéro de commande réel dans **ID de commande de test** et appuyer sur **Tester la connexion** pour vérifier que tout fonctionne sans attendre l'email d'un client, ou utiliser **Déconnecter** pour la délier. Dans certains comptes, cette intégration se configure automatiquement avec une configuration gérée par le serveur. Si ta carte dit déjà **Connecté** et mentionne la configuration du serveur, tu n'as rien à faire. ### Ajouter des liens de suivi aux réponses Les données de la commande sont à la disposition de l'agent, mais elles n'apparaîtront pas dans une réponse si tu ne lui dis pas de les utiliser. Pour cela, mentionne-les dans le prompt de conversation en utilisant des variables : des repères entre doubles accolades qui sont remplacés par la valeur réelle de chaque commande. Par exemple, ajoute ceci au prompt : > Quand le client pose une question sur l'expédition ou la livraison, inclus ce lien de suivi : Voici les variables disponibles : | Variable | Par quoi elle est remplacée | | -------------------------------------- | --------------------------- | | Le numéro de commande Amazon | | | | Le statut de la commande | | La place de marché ou le pays de vente | | | Le pays de destination | | | Le pays d'expédition | | | Le numéro de suivi | | | Le lien de suivi | | | Le transporteur | | | Le service d'expédition | | > **Note :** Pour que le lien de suivi se remplisse, l'intégration doit être connectée, la conversation email doit contenir un numéro de commande Amazon reconnaissable et la commande doit déjà avoir été expédiée : les données de suivi n'existent que lorsqu'Amazon les génère. D'autres outils devraient arriver dans cette section à mesure que le Gestionnaire d'Email avec IA sortira de la phase Beta. ## Comment vérifier que ça fonctionne Trois signes rapides que tout est en place : 1. Dans la liste **Agents email**, ton agent n'affiche plus **Aucune adresse email assignée** sous son nom. 2. Envoie un email de test à la boîte connectée depuis une autre de tes adresses, avec un texte qui correspond à une de tes catégories. 3. Attends quelques minutes et ouvre la section **Email**. Selon la configuration de cette catégorie, tu devrais trouver un brouillon prêt à relire ou une réponse déjà envoyée. S'il ne se passe rien, vérifie trois choses dans l'ordre : que la boîte est vraiment connectée, que **Répondre uniquement à un expéditeur spécifique** n'est pas activé en pointant vers une adresse différente de celle utilisée pour le test, et que ton email de test correspond vraiment à la description d'une catégorie : la réponse automatique ne part que lorsque le message est classé dans une catégorie avec la réponse automatique activée. ## Que faire ensuite * Crée deux ou trois catégories de plus maintenant que tu as vu l'agent en action. Les emails réels suggèrent toujours des étiquettes auxquelles tu n'avais pas pensé. * Visite la section **Email** chaque jour pendant la première semaine pour relire les brouillons de ton agent et affiner le prompt de conversation avec ce que tu apprends. * Jette un œil aux **Outils** de temps en temps : de nouvelles intégrations peuvent apparaître à mesure que le produit grandit. # Agent Templates Source: https://support.callin.io/Automations/Whitelabel/Agent-templates Pre-build agent templates so your users (subaccounts) can create agents faster with consistent settings. ## Overview **Agent Templates** let you pre-create a “ready-to-use” agent setup that your **subaccounts** can apply when creating new agents. Instead of configuring everything from scratch each time, you decide which settings are included in the template, and your users fill in only what’s needed. Use this section when you want: * **Consistent agent behavior** across multiple subaccounts. * Faster onboarding for new users. * A curated set of “approved” agent configurations. ## Open Agent Templates You can access the page here: [Agent Templates](https://app.callin.io/cms/agent-templates) ## Create a template 1. Open **Agent Templates**. 2. Click **Create Template**. 3. Fill out the template details: * **Template Name**: A clear name your subaccounts will recognize. * **Description**: A short explanation of what the template is for. > **Tip:** Use names that describe the job, not the team. Example: **“Inbound Customer Support”** instead of **“Support - Team A”**. ## Choose what subaccounts can configure When building a template, you’ll see a list of checkboxes under **Select Fields to Include**.\ **Checked = included in the template flow for subaccounts.**\ Unchecked fields won’t be part of the template setup. ### Basic information You can include fields such as: * **Agent Name** * **Greeting Message** * **System Prompt** * **Call Direction** * **Max Call Duration (minutes)** * **Dynamic Variables** * **Timezone** * **AI Model** * **Record Calls** * **Voicemail Detection** * **User Speaks First** > **Important:** Only include fields you actually want subaccounts to touch. Fewer fields usually means fewer mistakes. ### Voice & language You can include fields such as: * **Primary Language** * **Secondary Languages** * **Voice** * **Speech Speed** * **Temperature** > **Tip:** If you support multiple regions, include **Primary Language** and **Timezone** so subaccounts can adapt quickly without breaking the template’s intent. ### Call action You can include fields such as: * **Schedule Appointment** * **Scheduling Provider** * **Transfer Call** * **Send an Email** * **Opt-Out Call** * **Data Extraction** * **Data Extraction Entities** * **Post Call Webhook** * **Webhook URL** * **Retry Count** * **Retry Delay (minutes)** > **Common mistake:** Including **Webhook URL** for subaccounts when you want that to remain controlled by your organization. If you need centralized tracking, keep webhook-related fields restricted. ## Pre-deployed templates You may see an option called **Pre Deployed**. When enabled, an agent can be **automatically created using this template** for newly registered user accounts (behavior can vary by account/plan). > **Important:** Turn this on only for your “default starter” template. Otherwise, new users may get agents they didn’t intend to create. ## Template status You’ll also see **Template Status**.\ Only **active** templates are visible to subaccounts. Use this when you want to: * Temporarily hide older templates without deleting them. * Keep only your recommended templates available. ## Example: a practical template setup Here’s a realistic way to structure a template for an inbound support agent: **Template Name:** Inbound Customer Support\ **Description:** Handles inbound questions, collects basic details, and routes urgent cases. **Fields to include (recommended):** * Greeting Message * System Prompt * Call Direction * Timezone * Primary Language * Voice * Transfer Call (only if your workflow includes escalation) > **Tip:** If your subaccounts shouldn’t change core behavior, include the **System Prompt** but avoid exposing too many advanced toggles at the same time. ## Notes and limitations * What subaccounts see can depend on your role permissions and plan. * Some options and labels may vary slightly across accounts. If you want, you can create multiple templates by use case (e.g., **Sales Qualifier**, **Appointment Scheduler**, **Support Triage**) so subaccounts always start from the closest match. # Plantillas de agentes Source: https://support.callin.io/Automations/Whitelabel/Agent-templates-copied-1 Precrea plantillas de agentes para que tus usuarios (subcuentas) creen agentes más rápido y con configuraciones consistentes. ## Descripción general Las **Plantillas de agentes** te permiten precrear una configuración de agente “lista para usar” que tus **subcuentas** pueden aplicar al crear agentes nuevos. En lugar de configurar todo desde cero cada vez, tú decides qué ajustes se incluyen en la plantilla y tus usuarios completan solo lo necesario. Usa esta sección cuando quieras: * **Comportamiento consistente** del agente entre varias subcuentas. * Onboarding más rápido para usuarios nuevos. * Un conjunto curado de configuraciones “aprobadas” de agentes. ## Abrir Plantillas de agentes Puedes acceder a la página aquí: [Plantillas de agentes](https://app.callin.io/cms/agent-templates) ## Crear una plantilla 1. Abre **Plantillas de agentes**. 2. Haz clic en **Create Template**. 3. Completa los detalles de la plantilla: * **Template Name**: Un nombre claro que tus subcuentas reconozcan. * **Description**: Una explicación breve de para qué sirve la plantilla. > **Consejo:** Usa nombres que describan el trabajo, no el equipo. Ejemplo: **“Soporte al cliente entrante”** en lugar de **“Soporte - Equipo A”**. ## Elegir qué pueden configurar las subcuentas Al crear una plantilla, verás una lista de casillas bajo **Select Fields to Include**.\ **Marcado = incluido en el flujo de plantilla para las subcuentas.**\ Los campos no marcados no formarán parte de la configuración de la plantilla. ### Información básica Puedes incluir campos como: * **Agent Name** * **Greeting Message** * **System Prompt** * **Call Direction** * **Max Call Duration (minutes)** * **Dynamic Variables** * **Timezone** * **AI Model** * **Record Calls** * **Voicemail Detection** * **User Speaks First** > **Importante:** Incluye solo los campos que realmente quieres que las subcuentas toquen. Menos campos suele significar menos errores. ### Voz e idioma Puedes incluir campos como: * **Primary Language** * **Secondary Languages** * **Voice** * **Speech Speed** * **Temperature** > **Consejo:** Si atiendes varias regiones, incluye **Primary Language** y **Timezone** para que las subcuentas se adapten rápido sin romper la intención de la plantilla. ### Acción de llamada Puedes incluir campos como: * **Schedule Appointment** * **Scheduling Provider** * **Transfer Call** * **Send an Email** * **Opt-Out Call** * **Data Extraction** * **Data Extraction Entities** * **Post Call Webhook** * **Webhook URL** * **Retry Count** * **Retry Delay (minutes)** > **Error común:** Incluir **Webhook URL** para subcuentas cuando quieres que eso quede controlado por tu organización. Si necesitas un seguimiento centralizado, mantén restringidos los campos relacionados con webhooks. ## Plantillas predesplegadas Es posible que veas una opción llamada **Pre Deployed**. Cuando está activada, se puede **crear automáticamente un agente usando esta plantilla** para cuentas de usuario recién registradas (el comportamiento puede variar según tu cuenta/plan). > **Importante:** Actívalo solo para tu plantilla “starter” por defecto. De lo contrario, los usuarios nuevos pueden terminar con agentes que no pretendían crear. ## Estado de la plantilla También verás **Template Status**.\ Solo las plantillas **activas** son visibles para las subcuentas. Úsalo cuando quieras: * Ocultar temporalmente plantillas antiguas sin eliminarlas. * Mantener disponibles solo las plantillas recomendadas. ## Ejemplo: configuración práctica de una plantilla Una forma realista de estructurar una plantilla para un agente de soporte entrante: **Template Name:** Inbound Customer Support\ **Description:** Atiende preguntas entrantes, recopila información básica y deriva casos urgentes. **Campos a incluir (recomendado):** * Greeting Message * System Prompt * Call Direction * Timezone * Primary Language * Voice * Transfer Call (solo si tu flujo incluye escalamiento) > **Consejo:** Si tus subcuentas no deberían cambiar el comportamiento base, incluye el **System Prompt** pero evita exponer demasiados toggles avanzados al mismo tiempo. ## Notas y limitaciones * Lo que ven las subcuentas puede depender de permisos de rol y del plan. * Algunas opciones y etiquetas pueden variar ligeramente entre cuentas. Si quieres, puedes crear varias plantillas por caso de uso (por ejemplo, **Calificador de ventas**, **Agendador de citas**, **Triage de soporte**) para que las subcuentas siempre empiecen desde la opción más cercana. # Modèles d’agents Source: https://support.callin.io/Automations/Whitelabel/Agent-templates-copied-2 Créez des modèles d’agents à l’avance pour que vos utilisateurs (sous-comptes) puissent créer des agents plus rapidement avec des paramètres cohérents. ## Présentation Les **modèles d’agents** vous permettent de préconfigurer un agent « prêt à l’emploi » que vos **sous-comptes** peuvent utiliser lors de la création de nouveaux agents. Au lieu de tout configurer depuis zéro à chaque fois, vous choisissez quels paramètres font partie du modèle, et vos utilisateurs ne complètent que ce qui est nécessaire. Utilisez cette section si vous voulez : * Un **comportement cohérent** des agents sur plusieurs sous-comptes. * Un onboarding plus rapide pour les nouveaux utilisateurs. * Un ensemble de configurations d’agents « approuvées » et prêtes à l’emploi. ## Ouvrir Modèles d’agents Vous pouvez accéder à la page ici : [Modèles d’agents](https://app.callin.io/cms/agent-templates) ## Créer un modèle 1. Ouvrez **Modèles d’agents**. 2. Cliquez sur **Créer un modèle**. 3. Renseignez les informations du modèle : * **Nom du modèle** : un nom clair que vos sous-comptes reconnaîtront. * **Description** : une courte phrase expliquant l’objectif du modèle. > **Conseil :** Utilisez des noms qui décrivent le cas d’usage, pas l’équipe. Exemple : **« Support client entrant »** plutôt que **« Support – Équipe A »**. ## Choisir ce que les sous-comptes peuvent configurer Lors de la création d’un modèle, vous verrez une liste de cases à cocher dans **Sélectionner les champs à inclure**.\ **Coché = inclus dans le parcours du modèle pour les sous-comptes.**\ Les champs non cochés ne feront pas partie de la configuration via le modèle. ### Informations de base Vous pouvez inclure des champs comme : * **Nom de l’agent** * **Message d’accueil** * **Prompt système** * **Sens de l’appel** * **Durée maximale d’appel (minutes)** * **Variables dynamiques** * **Fuseau horaire** * **Modèle IA** * **Enregistrer les appels** * **Détection de messagerie vocale** * **L’utilisateur parle en premier** > **Important :** N’incluez que les champs que vous voulez réellement laisser aux sous-comptes. Moins il y a de champs, moins il y a d’erreurs. ### Voix et langue Vous pouvez inclure des champs comme : * **Langue principale** * **Langues secondaires** * **Voix** * **Vitesse d’élocution** * **Température** > **Conseil :** Si vous couvrez plusieurs régions, incluez **Langue principale** et **Fuseau horaire** afin que les sous-comptes puissent s’adapter rapidement sans dénaturer l’objectif du modèle. ### Action d’appel Vous pouvez inclure des champs comme : * **Planifier un rendez-vous** * **Fournisseur de planification** * **Transférer l’appel** * **Envoyer un e-mail** * **Désinscription (opt-out)** * **Extraction de données** * **Entités d’extraction de données** * **Webhook après appel** * **URL du webhook** * **Nombre de tentatives** * **Délai de nouvelle tentative (minutes)** > **Erreur courante :** Inclure **URL du webhook** pour les sous-comptes alors que vous souhaitez garder ce réglage sous contrôle de votre organisation. Si vous avez besoin d’un suivi centralisé, limitez l’accès aux champs liés aux webhooks. ## Modèles pré-déployés Vous pouvez voir une option appelée **Pré-déployé**. Lorsqu’elle est activée, un agent peut être **créé automatiquement à partir de ce modèle** pour les nouveaux comptes utilisateur (le comportement peut varier selon votre compte/forfait). > **Important :** Activez ceci uniquement pour votre modèle « starter » par défaut. Sinon, les nouveaux utilisateurs peuvent se retrouver avec des agents qu’ils n’avaient pas l’intention de créer. ## Statut du modèle Vous verrez aussi un **statut du modèle**.\ Seuls les modèles **actifs** sont visibles pour les sous-comptes. Utilisez cela pour : * Masquer temporairement d’anciens modèles sans les supprimer. * Ne laisser visibles que vos modèles recommandés. ## Exemple : une configuration de modèle réaliste Voici une approche réaliste pour structurer un modèle d’agent de support entrant : **Nom du modèle :** Support client entrant\ **Description :** Gère les questions entrantes, collecte les informations essentielles et oriente les cas urgents. **Champs à inclure (recommandé) :** * Message d’accueil * Prompt système * Sens de l’appel * Fuseau horaire * Langue principale * Voix * Transférer l’appel (uniquement si votre workflow prévoit une escalade) > **Conseil :** Si vos sous-comptes ne doivent pas modifier le comportement de base, incluez le **Prompt système** mais évitez d’exposer trop d’options avancées en même temps. ## Notes et limites * Ce que voient les sous-comptes peut dépendre de vos permissions de rôle et de votre forfait. * Certaines options et libellés peuvent légèrement varier selon les comptes. Si vous le souhaitez, vous pouvez créer plusieurs modèles par cas d’usage (par exemple **Qualification commerciale**, **Planification de rendez-vous**, **Triage support**) afin que les sous-comptes démarrent toujours avec l’option la plus pertinente. # Agentenvorlagen Source: https://support.callin.io/Automations/Whitelabel/Agent-templates-copied-4 Erstellen Sie Agentenvorlagen im Voraus, damit Ihre Nutzer (Unterkonten) Agents schneller und mit konsistenten Einstellungen anlegen können. ## Überblick Mit **Agentenvorlagen** können Sie eine „einsatzbereite“ Agent-Konfiguration vorab erstellen, die Ihre **Unterkonten** beim Erstellen neuer Agents verwenden. Statt jedes Mal alles von Grund auf einzurichten, legen Sie fest, welche Einstellungen zur Vorlage gehören, und Ihre Nutzer füllen nur das aus, was nötig ist. Nutzen Sie diesen Bereich, wenn Sie: * **Konsistentes Agent-Verhalten** über mehrere Unterkonten hinweg sicherstellen möchten. * Neues Onboarding beschleunigen wollen. * Eine kuratierte Auswahl „freigegebener“ Agent-Konfigurationen bereitstellen möchten. ## Agentenvorlagen öffnen Sie finden die Seite hier: [Agentenvorlagen](https://app.callin.io/cms/agent-templates) ## Eine Vorlage erstellen 1. Öffnen Sie **Agentenvorlagen**. 2. Klicken Sie auf **Vorlage erstellen**. 3. Tragen Sie die Vorlagen-Details ein: * **Vorlagenname**: ein klarer Name, den Unterkonten wiedererkennen. * **Beschreibung**: eine kurze Erklärung, wofür die Vorlage gedacht ist. > **Tipp:** Benennen Sie Vorlagen nach dem Zweck, nicht nach dem Team. Beispiel: **„Eingehender Kundensupport“** statt **„Support – Team A“**. ## Festlegen, was Unterkonten konfigurieren dürfen Beim Erstellen einer Vorlage sehen Sie eine Liste von Checkboxen unter **Felder auswählen, die enthalten sein sollen**.\ **Aktiviert = im Vorlagen-Flow für Unterkonten enthalten.**\ Nicht aktivierte Felder sind nicht Teil der Einrichtung über die Vorlage. ### Basisinformationen Sie können Felder aufnehmen wie: * **Agent-Name** * **Begrüßungsnachricht** * **System-Prompt** * **Anrufrichtung** * **Maximale Anrufdauer (Minuten)** * **Dynamische Variablen** * **Zeitzone** * **KI-Modell** * **Anrufe aufzeichnen** * **Mailbox-Erkennung** * **Nutzer spricht zuerst** > **Wichtig:** Nehmen Sie nur Felder auf, die Unterkonten wirklich bearbeiten sollen. Weniger Felder bedeuten in der Regel weniger Fehler. ### Stimme & Sprache Sie können Felder aufnehmen wie: * **Primäre Sprache** * **Sekundäre Sprachen** * **Stimme** * **Sprechgeschwindigkeit** * **Temperatur** > **Tipp:** Wenn Sie mehrere Regionen unterstützen, nehmen Sie **Primäre Sprache** und **Zeitzone** auf, damit Unterkonten schnell anpassen können, ohne die Absicht der Vorlage zu verändern. ### Anrufaktion Sie können Felder aufnehmen wie: * **Termin planen** * **Planungsanbieter** * **Anruf weiterleiten** * **E-Mail senden** * **Opt-out (Abmeldung)** * **Datenextraktion** * **Entitäten für Datenextraktion** * **Webhook nach dem Anruf** * **Webhook-URL** * **Anzahl der Wiederholungen** * **Wiederholungsverzögerung (Minuten)** > **Häufiger Fehler:** Die **Webhook-URL** für Unterkonten freizugeben, obwohl sie von Ihrer Organisation kontrolliert werden soll. Wenn Sie zentrales Tracking benötigen, beschränken Sie webhookbezogene Felder. ## Vorab bereitgestellte Vorlagen Möglicherweise sehen Sie eine Option namens **Vorab bereitgestellt**. Wenn sie aktiviert ist, kann automatisch ein Agent **auf Basis dieser Vorlage** für neu registrierte Nutzerkonten erstellt werden (das Verhalten kann je nach Konto/Plan variieren). > **Wichtig:** Aktivieren Sie dies nur für Ihre Standard-„Starter“-Vorlage. Andernfalls erhalten neue Nutzer möglicherweise Agents, die sie nicht erstellen wollten. ## Vorlagenstatus Sie sehen außerdem den **Vorlagenstatus**.\ Nur **aktive** Vorlagen sind für Unterkonten sichtbar. Das ist hilfreich, wenn Sie: * Ältere Vorlagen vorübergehend ausblenden möchten, ohne sie zu löschen. * Nur empfohlene Vorlagen verfügbar machen möchten. ## Beispiel: eine praxisnahe Vorlagenkonfiguration So könnte eine sinnvolle Vorlage für einen eingehenden Support-Agent aussehen: **Vorlagenname:** Eingehender Kundensupport\ **Beschreibung:** Beantwortet eingehende Fragen, sammelt Basisdaten und leitet dringende Fälle weiter. **Empfohlene Felder (aufnehmen):** * Begrüßungsnachricht * System-Prompt * Anrufrichtung * Zeitzone * Primäre Sprache * Stimme * Anruf weiterleiten (nur wenn Ihr Workflow eine Eskalation vorsieht) > **Tipp:** Wenn Unterkonten das Kernverhalten nicht verändern sollen, nehmen Sie den **System-Prompt** auf, aber vermeiden Sie es, zu viele fortgeschrittene Schalter gleichzeitig freizugeben. ## Hinweise und Einschränkungen * Was Unterkonten sehen, kann von Rollenberechtigungen und Ihrem Plan abhängen. * Einige Optionen und Bezeichnungen können je nach Konto leicht variieren. Wenn Sie möchten, können Sie mehrere Vorlagen nach Anwendungsfall erstellen (z. B. **Sales-Qualifizierung**, **Terminplanung**, **Support-Triage**), damit Unterkonten immer mit der passendsten Option starten. # Users Source: https://support.callin.io/Automations/Whitelabel/Clients Manage your customers: create accounts, review subscription status, and open the customer app from one place. ## What this page is for The **Users** page is where you manage the *customers of your White Label* (the people who buy subscriptions and use your branded app). From here you can: * Create new customer accounts * Search and review customers in your workspace * Update basic customer details (like name and company) * Review customer information such as subscriptions, minutes, and attribution (inside the user details panel) * Open the customer’s app directly using the **green icon** on the far right of the row (the last icon) To open this page, click here: [Open Users](https://app.callin.io/cms/users) ## How the Users list works At the top of the page, you’ll see: * A **search bar** to quickly find a customer (commonly by name or email) * A **Create User** button to add a new customer Each row in the table represents a customer and typically shows: * Customer identity (name/email) * Status (for example, **Active**) * A join date (**Joined At** in the UI) * Several action icons on the right side of the row (including the **green icon** at the end) ## Create a customer account When you click **Create User**, a modal opens to create a new customer. What you’ll fill in (based on the UI): * **Email** (required) * **Password** (required — the modal indicates a minimum length) * **Full Name** (optional) * **Company** (optional) Realistic example: * Email → `sara@northwindclinic.com` * Password → a secure password you share with the customer through a safe channel * Full Name → `Sara Ruiz` * Company → `Northwind Clinic` > **Tip:** If you manage many accounts, keeping **Full Name** and **Company** filled in makes search and support much easier. ## Edit basic customer details From a user row, you can open an edit modal to update basic fields like: * **Full Name** * **Company** This is useful when: * A customer signed up with an incomplete name * You want the company name to match your internal naming (for example, “Northwind Clinic (Madrid)”) ## Open the customer app with the green icon The last icon on the right side of each row is a **green icon**. This is the fast way to open the customer’s platform directly. Use it when you need to: * Confirm exactly what the customer is seeing * Check whether a feature is available based on their subscription * Help the customer find a page without guessing Support example: 1. The customer says: “I can’t find my subscriptions.” 2. You locate them in **Users**. 3. You click the **green icon** to open their app and guide them with certainty. > **Important:** What you see after opening the customer app depends on that customer’s current status and subscription. ## What you can review inside a customer profile When you open the customer details panel, the UI shows tabs such as: * **Info** (last login details and account security options) * **Subscriptions** (minutes, active subscriptions, and billing actions if available) * **1-Min Billing** (outbound billing rule details and recent outbound call stats) * **UTM** (marketing attribution captured during signup) This helps you quickly answer questions like: * “Did this customer log in recently?” * “Do they have an active subscription?” * “Why was a short outbound call billed a certain way?” * “Did they come from a campaign with UTM parameters?” > **Tip:** If a customer says “I paid but it’s not active,” the first check is usually confirming they’re using the correct email/account. # Usuarios Source: https://support.callin.io/Automations/Whitelabel/Clients-copied-1 Administra a tus clientes: crea cuentas, revisa su estado de suscripción y accede a su app de cliente desde un solo lugar. ## Para qué sirve esta página La página de **Usuarios** es donde administras a los *clientes de tu White Label* (las personas que compran suscripciones y usan tu app con marca). Desde aquí puedes: * Crear nuevas cuentas de cliente * Buscar y revisar clientes en tu workspace * Actualizar datos básicos del cliente (como nombre y empresa) * Revisar información del cliente como suscripción, minutos y atribución (dentro del panel de detalles del usuario) * Acceder directamente a la app del cliente usando el **icono verde** del extremo derecho de la fila (el último icono) Para abrir esta página, haz clic aquí: [Abrir Usuarios](https://app.callin.io/cms/users) ## Cómo funciona la lista de Usuarios En la parte superior de la página verás: * Una **barra de búsqueda** para encontrar rápido a un cliente (normalmente por nombre o email). * Un botón **Create User** para añadir un nuevo cliente. Cada fila de la tabla representa un cliente y muestra: * Identidad del cliente (nombre/email) * Estado (por ejemplo, **Active**) * Fecha de alta (**Joined At** en la interfaz) * Varios iconos de acción en el lado derecho de la fila (incluyendo el **icono verde** al final) ## Crear una cuenta de cliente Cuando haces clic en **Create User**, se abre un modal para crear un cliente nuevo. Lo que completarás (según la interfaz): * **Email** (obligatorio) * **Password** (obligatorio — el modal indica una longitud mínima) * **Full Name** (opcional) * **Company** (opcional) Ejemplo realista: * Email → `sara@northwindclinic.com` * Password → una contraseña segura que compartes con el cliente por un canal seguro * Full Name → `Sara Ruiz` * Company → `Northwind Clinic` > **Consejo:** Si gestionas muchas cuentas, mantener **Full Name** y **Company** bien rellenados hace que la búsqueda sea mucho más fácil. ## Editar datos básicos del cliente Desde una fila de usuario, puedes abrir un modal de edición para actualizar campos básicos como: * **Full Name** * **Company** Esto es útil cuando: * El cliente se registró con un nombre incompleto * Quieres que el nombre de empresa siga tu criterio interno (por ejemplo, “Northwind Clinic (Madrid)”) ## Acceder a la app del cliente con el icono verde El último icono de la derecha en cada fila es un **icono verde**. Es la forma rápida de entrar directamente en la plataforma del cliente. Úsalo cuando necesites: * Confirmar exactamente lo que el cliente está viendo * Ver si una funcionalidad aparece según su suscripción * Ayudar al cliente a encontrar una sección sin suposiciones Ejemplo de soporte: 1. El cliente dice: “No encuentro mis suscripciones.” 2. Lo localizas en **Usuarios**. 3. Haces clic en el **icono verde** para abrir su app y guiarle con certeza. > **Importante:** Lo que veas al abrir la app del cliente depende del estado y la suscripción actual de ese cliente. ## Qué puedes revisar dentro del perfil de un cliente Al abrir el panel de detalles de un cliente, la interfaz muestra pestañas como: * **Info** (detalles del último acceso y opciones de seguridad de la cuenta) * **Subscriptions** (minutos, suscripciones activas y acciones de facturación si están disponibles) * **1-Min Billing** (regla de facturación saliente y estadísticas de llamadas recientes) * **UTM** (atribución de marketing capturada durante el registro) Esto te ayuda a responder rápido preguntas como: * “¿Este cliente ha entrado recientemente?” * “¿Tiene una suscripción activa?” * “¿Por qué se facturó de cierta manera una llamada corta?” * “¿Viene de una campaña con parámetros UTM?” > **Consejo:** Si un cliente dice “he pagado pero no aparece activo”, lo primero suele ser comprobar si está usando el email/cuenta correctos. # Utilisateurs Source: https://support.callin.io/Automations/Whitelabel/Clients-copied-2 Gérez vos clients : créez des comptes, vérifiez l’état de leur abonnement et accédez à leur application client depuis un seul endroit. ## À quoi sert cette page La page **Utilisateurs** est l’endroit où vous gérez les *clients de votre White Label* (les personnes qui achètent des abonnements et utilisent votre application sous marque). Depuis ici, vous pouvez : * Créer de nouveaux comptes clients * Rechercher et consulter des clients dans votre espace de travail * Mettre à jour les informations de base d’un client (comme le nom et l’entreprise) * Consulter des informations comme l’abonnement, les minutes et l’attribution (dans le panneau de détails de l’utilisateur) * Accéder directement à l’application du client via l’**icône verte** tout à droite de la ligne (la dernière icône) Pour ouvrir cette page, cliquez ici : [Ouvrir Utilisateurs](https://app.callin.io/cms/users) ## Comment fonctionne la liste des Utilisateurs En haut de la page, vous verrez : * Une **barre de recherche** pour trouver rapidement un client (généralement par nom ou email). * Un bouton **Create User** pour ajouter un nouveau client. Chaque ligne du tableau représente un client et affiche : * L’identité du client (nom/email) * Le statut (par exemple **Active**) * La date d’inscription (**Joined At** dans l’interface) * Plusieurs icônes d’action à droite (dont l’**icône verte** à la fin) ## Créer un compte client Lorsque vous cliquez sur **Create User**, une fenêtre s’ouvre pour créer un nouveau client. Ce que vous remplirez (selon l’interface) : * **Email** (obligatoire) * **Password** (obligatoire — la fenêtre indique une longueur minimale) * **Full Name** (optionnel) * **Company** (optionnel) Exemple réaliste : * Email → `sara@northwindclinic.com` * Password → un mot de passe sécurisé que vous partagez avec le client via un canal sûr * Full Name → `Sara Ruiz` * Company → `Northwind Clinic` > **Conseil :** Si vous gérez beaucoup de comptes, renseigner correctement **Full Name** et **Company** rend la recherche beaucoup plus simple. ## Modifier les informations de base d’un client Depuis une ligne utilisateur, vous pouvez ouvrir une fenêtre d’édition pour mettre à jour des champs de base comme : * **Full Name** * **Company** C’est utile lorsque : * Le client s’est inscrit avec un nom incomplet * Vous souhaitez que le nom de l’entreprise suive votre logique interne (par exemple « Northwind Clinic (Madrid) ») ## Accéder à l’application du client via l’icône verte La dernière icône à droite de chaque ligne est une **icône verte**. C’est le moyen le plus rapide d’ouvrir directement la plateforme du client. Utilisez-la lorsque vous devez : * Confirmer exactement ce que le client voit * Vérifier si une fonctionnalité s’affiche selon son abonnement * Aider le client à trouver une section sans supposer Exemple de support : 1. Le client dit : « Je ne trouve pas mes abonnements. » 2. Vous le retrouvez dans **Utilisateurs**. 3. Vous cliquez sur l’**icône verte** pour ouvrir son application et le guider avec certitude. > **Important :** Ce que vous verrez en ouvrant l’application du client dépend du statut et de l’abonnement actuel de ce client. ## Ce que vous pouvez consulter dans le profil d’un client En ouvrant le panneau de détails d’un client, l’interface affiche des onglets comme : * **Info** (détails de la dernière connexion et options de sécurité du compte) * **Subscriptions** (minutes, abonnements actifs et actions de facturation si disponibles) * **1-Min Billing** (règle de facturation sortante et statistiques des appels récents) * **UTM** (attribution marketing capturée lors de l’inscription) Cela vous aide à répondre rapidement à des questions comme : * « Ce client s’est-il connecté récemment ? » * « A-t-il un abonnement actif ? » * « Pourquoi un appel court a-t-il été facturé de cette façon ? » * « Vient-il d’une campagne avec des paramètres UTM ? » > **Conseil :** Si un client dit « j’ai payé mais ça n’apparaît pas actif », la première vérification est souvent de confirmer qu’il utilise le bon email/compte. # Utenti Source: https://support.callin.io/Automations/Whitelabel/Clients-copied-3 Gestisci i tuoi clienti: crea account, controlla lo stato dell’abbonamento e accedi all’app del cliente da un unico posto. ## A cosa serve questa pagina La pagina **Utenti** è dove gestisci i *clienti del tuo White Label* (le persone che acquistano abbonamenti e usano la tua app brandizzata). Da qui puoi: * Creare nuovi account cliente * Cercare e consultare clienti nel tuo workspace * Aggiornare i dati di base del cliente (come nome e azienda) * Consultare informazioni come abbonamento, minuti e attribuzione (nel pannello dettagli dell’utente) * Accedere direttamente all’app del cliente tramite l’**icona verde** all’estrema destra della riga (l’ultima icona) Per aprire questa pagina, clicca qui: [Apri Utenti](https://app.callin.io/cms/users) ## Come funziona la lista Utenti Nella parte alta della pagina vedrai: * Una **barra di ricerca** per trovare rapidamente un cliente (di solito per nome o email). * Un pulsante **Create User** per aggiungere un nuovo cliente. Ogni riga della tabella rappresenta un cliente e mostra: * Identità del cliente (nome/email) * Stato (ad esempio **Active**) * Data di registrazione (**Joined At** nell’interfaccia) * Diverse icone di azione sul lato destro (inclusa l’**icona verde** alla fine) ## Creare un account cliente Quando clicchi su **Create User**, si apre una finestra per creare un nuovo cliente. Cosa compilerai (in base all’interfaccia): * **Email** (obbligatorio) * **Password** (obbligatorio — la finestra indica una lunghezza minima) * **Full Name** (opzionale) * **Company** (opzionale) Esempio realistico: * Email → `sara@northwindclinic.com` * Password → una password sicura che condividi con il cliente tramite un canale sicuro * Full Name → `Sara Ruiz` * Company → `Northwind Clinic` > **Consiglio:** Se gestisci molti account, compilare bene **Full Name** e **Company** rende la ricerca molto più semplice. ## Modificare i dati di base del cliente Da una riga utente, puoi aprire una finestra di modifica per aggiornare campi di base come: * **Full Name** * **Company** È utile quando: * Il cliente si è registrato con un nome incompleto * Vuoi che il nome dell’azienda segua il tuo criterio interno (ad esempio “Northwind Clinic (Madrid)”) ## Accedere all’app del cliente con l’icona verde L’ultima icona sulla destra di ogni riga è un’**icona verde**. È il modo più rapido per aprire direttamente la piattaforma del cliente. Usala quando devi: * Confermare esattamente cosa vede il cliente * Verificare se una funzione è disponibile in base al suo abbonamento * Aiutare il cliente a trovare una sezione senza supposizioni Esempio di supporto: 1. Il cliente dice: “Non trovo i miei abbonamenti.” 2. Lo cerchi in **Utenti**. 3. Clicchi sull’**icona verde** per aprire la sua app e guidarlo con certezza. > **Importante:** Ciò che vedrai aprendo l’app del cliente dipende dallo stato e dall’abbonamento attuale di quel cliente. ## Cosa puoi consultare nel profilo di un cliente Aprendo il pannello dettagli di un cliente, l’interfaccia mostra schede come: * **Info** (dettagli dell’ultimo accesso e opzioni di sicurezza dell’account) * **Subscriptions** (minuti, abbonamenti attivi e azioni di fatturazione se disponibili) * **1-Min Billing** (regola di fatturazione in uscita e statistiche delle chiamate recenti) * **UTM** (attribuzione marketing catturata durante la registrazione) Questo ti aiuta a rispondere rapidamente a domande come: * “Questo cliente ha effettuato l’accesso di recente?” * “Ha un abbonamento attivo?” * “Perché una chiamata breve è stata fatturata in questo modo?” * “Proviene da una campagna con parametri UTM?” > **Consiglio:** Se un cliente dice “ho pagato ma non risulta attivo”, il primo controllo è spesso verificare che stia usando l’email/account corretto. # Benutzer Source: https://support.callin.io/Automations/Whitelabel/Clients-copied-4 Verwalten Sie Ihre Kunden: Konten anlegen, den Abostatus prüfen und die Kunden-App von einem Ort aus öffnen. ## Wofür diese Seite da ist Auf der Seite **Benutzer** verwalten Sie die *Kunden Ihres White Labels* (die Personen, die Abonnements kaufen und Ihre gebrandete App nutzen). Von hier aus können Sie: * Neue Kundenkonten anlegen * Kunden in Ihrem Workspace suchen und einsehen * Grunddaten des Kunden aktualisieren (z. B. Name und Firma) * Informationen wie Abonnement, Minuten und Attribution prüfen (im Detailpanel des Benutzers) * Die Kunden-App direkt über das **grüne Symbol** ganz rechts in der Zeile öffnen (das letzte Symbol) Zum Öffnen dieser Seite klicken Sie hier: [Benutzer öffnen](https://app.callin.io/cms/users) ## Wie die Benutzerliste funktioniert Oben auf der Seite sehen Sie: * Eine **Suchleiste**, um Kunden schnell zu finden (meist nach Name oder E-Mail). * Eine Schaltfläche **Create User**, um einen neuen Kunden hinzuzufügen. Jede Tabellenzeile steht für einen Kunden und zeigt: * Kundenidentität (Name/E-Mail) * Status (z. B. **Active**) * Registrierungsdatum (**Joined At** in der Oberfläche) * Mehrere Aktionssymbole rechts (einschließlich des **grünen Symbols** am Ende) ## Ein Kundenkonto erstellen Wenn Sie auf **Create User** klicken, öffnet sich ein Dialog, um einen neuen Kunden anzulegen. Was Sie ausfüllen (laut Oberfläche): * **Email** (erforderlich) * **Password** (erforderlich — der Dialog nennt eine Mindestlänge) * **Full Name** (optional) * **Company** (optional) Realistisches Beispiel: * Email → `sara@northwindclinic.com` * Password → ein sicheres Passwort, das Sie dem Kunden über einen sicheren Kanal mitteilen * Full Name → `Sara Ruiz` * Company → `Northwind Clinic` > **Tipp:** Wenn Sie viele Konten verwalten, helfen sauber gepflegte Felder **Full Name** und **Company** enorm bei der späteren Suche. ## Grunddaten eines Kunden bearbeiten Aus einer Benutzerzeile können Sie einen Bearbeitungsdialog öffnen, um Basisfelder zu aktualisieren wie: * **Full Name** * **Company** Das ist hilfreich, wenn: * Der Kunde sich mit einem unvollständigen Namen registriert hat * Sie den Firmennamen nach Ihrer internen Logik vereinheitlichen möchten (z. B. „Northwind Clinic (Madrid)“) ## Die Kunden-App über das grüne Symbol öffnen Das letzte Symbol rechts in jeder Zeile ist ein **grünes Symbol**. Damit öffnen Sie die Kundenplattform direkt. Nutzen Sie es, wenn Sie: * Genau prüfen möchten, was der Kunde sieht * Verifizieren möchten, ob eine Funktion je nach Abonnement sichtbar ist * Den Kunden ohne Vermutungen zu einer bestimmten Seite führen möchten Support-Beispiel: 1. Der Kunde sagt: „Ich finde meine Abonnements nicht.“ 2. Sie suchen ihn unter **Benutzer**. 3. Sie klicken auf das **grüne Symbol**, öffnen seine App und leiten ihn gezielt an. > **Wichtig:** Was Sie nach dem Öffnen der Kunden-App sehen, hängt vom Status und dem aktuellen Abonnement dieses Kunden ab. ## Was Sie im Kundenprofil prüfen können Wenn Sie das Detailpanel eines Kunden öffnen, zeigt die Oberfläche Tabs wie: * **Info** (Details zur letzten Anmeldung und Sicherheitsoptionen des Kontos) * **Subscriptions** (Minuten, aktive Abonnements und ggf. verfügbare Abrechnungsaktionen) * **1-Min Billing** (Regel zur Abrechnung ausgehender Anrufe und Statistiken zu letzten Calls) * **UTM** (Marketing-Attribution, die bei der Registrierung erfasst wurde) Damit können Sie schnell Fragen beantworten wie: * „Hat sich dieser Kunde kürzlich eingeloggt?“ * „Hat er ein aktives Abonnement?“ * „Warum wurde ein kurzer Anruf so abgerechnet?“ * „Kam er über eine Kampagne mit UTM-Parametern?“ > **Tipp:** Wenn ein Kunde sagt „ich habe bezahlt, aber es ist nicht aktiv“, prüfen Sie zuerst, ob er die richtige E-Mail/das richtige Konto nutzt. # FAQs Source: https://support.callin.io/Automations/Whitelabel/Faqs Create and manage the frequently asked questions your sub-accounts will see inside your white-label app. ## What this section is for **FAQs** is where you write the most common questions your customers ask—and the answers you want them to see instantly inside your app. This is especially useful in a white-label setup, because it helps you: * Reduce repetitive support tickets. * Set clear expectations about billing and usage. * Explain how your plans work in simple language. > **Important:** Sub-accounts won’t see Callin’s official documentation here. This FAQ section is for **your own** customer-facing answers. [Click here to open FAQs](https://app.callin.io/cms/faqs)Screenshot: the FAQs list where you can add new questions, search existing ones, and manage which FAQs are active.
## How FAQs work Each FAQ is made of: * **A question** (what the user reads) * **An answer** (your official explanation) * An **Active** toggle/status (so you can show or hide it) When an FAQ is active, it can be shown to your sub-accounts inside the app (exact placement can vary depending on your setup). > **Tip:** Keep answers short and direct. If a topic is long, link to your documentation in the **Guides** section instead. ## Add a new FAQ 1. Click **Add FAQ**. 2. Fill in: * **Question**: write it exactly like a user would ask it. * **Answer**: give a clear, friendly answer in 3–6 lines. 3. Leave it as **Active** if you want it visible immediately. 4. Click **Save**. > **Common mistake:** Writing answers like internal notes. FAQs should be customer-friendly and avoid technical jargon. ## Examples you can copy and adapt Below are realistic FAQ examples (with sample answers) you can use as a starting point. ### Example 1: Plan upgrades **Question:** Can I upgrade my plan anytime?\ **Answer:** Yes. You can upgrade at any time. The new plan will apply to your next billing cycle. If anything changes immediately in your account, you’ll see it reflected right away. ### Example 2: Buying extra minutes **Question:** Can I purchase extra minutes?\ **Answer:** If your plan allows additional minutes, you can buy extra minutes once you reach your included limit. The extra minutes are charged at the rate defined in your plan. ### Example 3: Unused minutes **Question:** Do unused minutes carry over to the next month?\ **Answer:** In most cases, unused minutes do not roll over. Your monthly minutes reset at the start of each billing cycle. (This can vary depending on your plan rules.) ### Example 4: Payment issues **Question:** My payment failed—what happens now?\ **Answer:** If a payment fails, your subscription may move into a payment-due state until the issue is resolved. Update your payment method and try again. If you need help, contact support. > **Important:** If you mention rules like rollover or grace periods, make sure they match how your billing is configured. ## Managing existing FAQs From the FAQs list you can typically: * **Search** for a question using the search bar. * **Activate/Deactivate** an FAQ to show or hide it. * **Edit** a question/answer if your policies change. > **Tip:** Review your FAQs once a month. The best FAQs evolve based on what your support team gets asked the most. # Preguntas frecuentes Source: https://support.callin.io/Automations/Whitelabel/Faqs-copied-1 Crea y gestiona las preguntas frecuentes que verán tus subcuentas dentro de tu app de marca blanca. ## Para qué sirve esta sección **Preguntas frecuentes** es el lugar donde escribes las dudas más habituales de tus clientes y las respuestas que quieres que vean al instante dentro de tu app. Esto es especialmente útil en un entorno de marca blanca, porque te ayuda a: * Reducir tickets repetidos de soporte. * Dejar claras las reglas de facturación y uso. * Explicar cómo funcionan tus planes con un lenguaje sencillo. > **Importante:** Las subcuentas no verán aquí la documentación oficial de Callin. Esta sección es para tus **propias** respuestas de cara al cliente. [Haz clic aquí para abrir Preguntas frecuentes](https://app.callin.io/cms/faqs)Captura: listado de Preguntas frecuentes, donde puedes añadir nuevas preguntas, buscar las existentes y gestionar cuáles están activas.
## Cómo funcionan las preguntas frecuentes Cada pregunta frecuente se compone de: * **Una pregunta** (lo que lee el usuario) * **Una respuesta** (tu explicación “oficial”) * Un estado de **activo** (para mostrarla u ocultarla) Cuando una pregunta está activa, puede mostrarse a tus subcuentas dentro de la app (la ubicación exacta puede variar según tu configuración). > **Consejo:** Mantén las respuestas cortas y directas. Si un tema es largo, enlaza a tu documentación en la sección de **Guías**. ## Añadir una nueva pregunta frecuente 1. Pulsa el botón para **añadir una pregunta**. 2. Rellena: * **Pregunta**: escríbela tal cual la diría un cliente. * **Respuesta**: da una respuesta clara y amable en 3–6 líneas. 3. Déjala como **activa** si quieres que se vea de inmediato. 4. Pulsa **guardar**. > **Error común:** Escribir respuestas como notas internas. Las preguntas frecuentes deben ser fáciles de entender y sin jerga técnica. ## Ejemplos que puedes copiar y adaptar A continuación tienes ejemplos realistas (con respuestas de muestra) para usarlos como base. ### Ejemplo 1: Cambiar de plan **Pregunta:** ¿Puedo cambiar a un plan superior en cualquier momento?\ **Respuesta:** Sí. Puedes pasar a un plan superior cuando quieras. El nuevo plan se aplicará en el siguiente ciclo de facturación. Si algo cambia de forma inmediata en tu cuenta, lo verás reflejado al momento. ### Ejemplo 2: Comprar minutos extra **Pregunta:** ¿Puedo comprar minutos adicionales?\ **Respuesta:** Si tu plan permite minutos adicionales, podrás comprar minutos extra cuando alcances el límite incluido. Los minutos extra se cobran según la tarifa definida en tu plan. ### Ejemplo 3: Minutos no usados **Pregunta:** ¿Los minutos no usados se acumulan para el mes siguiente?\ **Respuesta:** En la mayoría de casos, los minutos no se acumulan. Tus minutos mensuales se reinician al empezar cada ciclo de facturación. (Esto puede variar según las reglas de tu plan.) ### Ejemplo 4: Problemas de pago **Pregunta:** Mi pago ha fallado, ¿qué ocurre ahora?\ **Respuesta:** Si un pago falla, tu suscripción puede pasar a un estado de pago pendiente hasta que se resuelva. Actualiza tu método de pago e inténtalo de nuevo. Si necesitas ayuda, contacta con soporte. > **Importante:** Si mencionas reglas como acumulación de minutos o periodos de gracia, asegúrate de que coinciden con tu configuración de facturación. ## Gestionar preguntas existentes Desde el listado normalmente puedes: * **Buscar** una pregunta con la barra de búsqueda. * **Activar/Desactivar** una pregunta para mostrarla u ocultarla. * **Editar** la pregunta o la respuesta si cambian tus políticas. > **Consejo:** Revisa tus preguntas frecuentes una vez al mes. Las mejores preguntas frecuentes evolucionan según lo que más pregunta tu soporte. # Domande frequenti Source: https://support.callin.io/Automations/Whitelabel/Faqs-copied-2 Crea e gestisci le domande frequenti che i tuoi sotto-account vedranno nella tua app in white label. ## A cosa serve questa sezione La sezione **Domande frequenti** ti permette di scrivere le domande più comuni dei tuoi clienti e le risposte che vuoi far trovare subito all’interno della tua app. È particolarmente utile in un contesto white label perché ti aiuta a: * Ridurre richieste ripetitive al supporto. * Chiarire regole di fatturazione e utilizzo. * Spiegare come funzionano le tue offerte con un linguaggio semplice. > **Importante:** I sotto-account non vedranno qui la documentazione ufficiale di Callin. Questa sezione serve per le **tue** risposte rivolte ai clienti. [Fai clic qui per aprire Domande frequenti](https://app.callin.io/cms/faqs)Schermata: elenco delle domande, con ricerca, aggiunta e gestione degli elementi attivi.
## Come funzionano le domande frequenti Ogni voce contiene: * **Una domanda** (ciò che legge l’utente) * **Una risposta** (la tua spiegazione ufficiale) * Uno stato **attivo** (per mostrarla o nasconderla) Quando una domanda è attiva, può essere visibile ai sotto-account nell’app (la posizione esatta può variare in base alla configurazione). > **Consiglio:** Mantieni le risposte brevi e dirette. Se un argomento è lungo, inserisci un link alla tua documentazione nella sezione **Guide**. ## Aggiungere una nuova domanda 1. Clicca su **Aggiungi domanda**. 2. Compila: * **Domanda**: scrivila come la farebbe un cliente. * **Risposta**: rispondi in modo chiaro, in 3–6 righe. 3. Lasciala **attiva** se vuoi renderla visibile subito. 4. Salva. > **Errore comune:** Scrivere risposte come appunti interni. Le domande frequenti devono essere semplici e senza linguaggio tecnico inutile. ## Esempi da copiare e adattare Ecco esempi realistici (con risposte) da usare come base. ### Esempio 1: Passare a un’offerta superiore **Domanda:** Posso passare a un’offerta superiore in qualsiasi momento?\ **Risposta:** Sì. Puoi passare a un’offerta superiore quando vuoi. Di solito la nuova offerta si applica dal prossimo ciclo di fatturazione. Se alcuni aspetti cambiano subito, lo vedrai immediatamente nel tuo account. ### Esempio 2: Acquistare minuti extra **Domanda:** Posso acquistare minuti aggiuntivi?\ **Risposta:** Se la tua offerta consente minuti aggiuntivi, potrai comprarli quando raggiungi i minuti inclusi. I minuti extra vengono addebitati alla tariffa prevista dalla tua offerta. ### Esempio 3: Minuti non utilizzati **Domanda:** I minuti non utilizzati si accumulano per il mese successivo?\ **Risposta:** Nella maggior parte dei casi, i minuti non si accumulano. I minuti mensili si azzerano all’inizio di ogni ciclo di fatturazione. (Questo può variare in base alle regole della tua offerta.) ### Esempio 4: Pagamento non riuscito **Domanda:** Il mio pagamento non è andato a buon fine: cosa succede?\ **Risposta:** Se un pagamento fallisce, l’abbonamento può passare a uno stato di “pagamento in sospeso” finché il problema non viene risolto. Aggiorna il metodo di pagamento e riprova. Se serve, contatta l’assistenza. > **Importante:** Se citi regole come accumulo minuti o periodi di tolleranza, assicurati che corrispondano alla tua configurazione di fatturazione. ## Gestire le domande esistenti Dall’elenco puoi in genere: * **Cercare** una domanda tramite la barra di ricerca. * **Attivare/Disattivare** una voce per mostrarla o nasconderla. * **Modificare** domanda o risposta quando cambiano le regole. > **Consiglio:** Rivedi le domande frequenti una volta al mese. Le migliori domande frequenti evolvono in base a ciò che il supporto riceve più spesso. # Häufig gestellte Fragen Source: https://support.callin.io/Automations/Whitelabel/Faqs-copied-3 Erstellen und verwalten Sie die häufig gestellten Fragen, die Ihre Unterkonten in Ihrer White-Label-App sehen. ## Wofür dieser Bereich gedacht ist In **Häufig gestellte Fragen** hinterlegen Sie die typischen Fragen Ihrer Kundschaft und die Antworten, die Nutzer sofort in Ihrer App finden sollen. Gerade im White-Label-Setup hilft Ihnen das dabei: * Wiederkehrende Supportanfragen zu reduzieren. * Regeln zu Abrechnung und Nutzung klar zu kommunizieren. * Ihre Angebote in einfacher Sprache zu erklären. > **Wichtig:** Unterkonten sehen hier nicht die offizielle Callin-Dokumentation. Dieser Bereich ist für **Ihre eigenen** kundenorientierten Antworten. [Klicken Sie hier, um Häufig gestellte Fragen zu öffnen](https://app.callin.io/cms/faqs)Screenshot: Fragenliste mit Suche, Hinzufügen neuer Einträge und Verwaltung aktiver Fragen.
## So funktionieren häufig gestellte Fragen Jeder Eintrag besteht aus: * **Einer Frage** (was Nutzer lesen) * **Einer Antwort** (Ihre offizielle Erklärung) * Einem **Aktiv-Status** (zum Anzeigen oder Ausblenden) Wenn ein Eintrag aktiv ist, kann er Unterkonten in der App angezeigt werden (die genaue Platzierung kann je nach Konfiguration variieren). > **Tipp:** Halten Sie Antworten kurz und eindeutig. Für längere Themen verlinken Sie Ihre Dokumentation in der Rubrik **Anleitungen**. ## Eine neue Frage hinzufügen 1. Klicken Sie auf **Frage hinzufügen**. 2. Tragen Sie ein: * **Frage**: formulieren Sie sie so, wie ein Kunde sie stellen würde. * **Antwort**: geben Sie eine klare Antwort in 3–6 Zeilen. 3. Lassen Sie den Eintrag **aktiv**, wenn er sofort sichtbar sein soll. 4. Speichern Sie. > **Häufiger Fehler:** Antworten wie interne Notizen zu schreiben. Dieser Bereich sollte leicht verständlich sein und unnötigen Fachjargon vermeiden. ## Beispiele zum Kopieren und Anpassen Hier sind realistische Beispiele (mit Musterantworten) als Startpunkt. ### Beispiel 1: Tarifwechsel nach oben **Frage:** Kann ich jederzeit auf einen höheren Tarif wechseln?\ **Antwort:** Ja. Sie können jederzeit auf einen höheren Tarif wechseln. In der Regel gilt der neue Tarif ab dem nächsten Abrechnungszeitraum. Wenn sich etwas sofort in Ihrem Konto ändert, sehen Sie das direkt. ### Beispiel 2: Zusätzliche Minuten kaufen **Frage:** Kann ich zusätzliche Minuten kaufen?\ **Antwort:** Wenn Ihr Tarif zusätzliche Minuten erlaubt, können Sie nach Erreichen des enthaltenen Kontingents weitere Minuten erwerben. Diese werden zum in Ihrem Tarif festgelegten Preis pro Minute berechnet. ### Beispiel 3: Nicht genutzte Minuten **Frage:** Werden nicht genutzte Minuten in den nächsten Monat übernommen?\ **Antwort:** In den meisten Fällen werden Minuten nicht übertragen. Ihr monatliches Kontingent wird zu Beginn jedes Abrechnungszeitraums zurückgesetzt. (Das kann je nach Tarifregeln variieren.) ### Beispiel 4: Zahlungsproblem **Frage:** Meine Zahlung ist fehlgeschlagen – was passiert jetzt?\ **Antwort:** Wenn eine Zahlung fehlschlägt, kann Ihr Abonnement in einen Status „Zahlung ausstehend“ wechseln, bis das Problem gelöst ist. Aktualisieren Sie die Zahlungsmethode und versuchen Sie es erneut. Wenn Sie Hilfe benötigen, kontaktieren Sie den Support. > **Wichtig:** Wenn Sie Regeln wie Minutenübertrag oder Kulanzzeiten erwähnen, stellen Sie sicher, dass sie zu Ihrer Abrechnungskonfiguration passen. ## Bestehende Einträge verwalten In der Liste können Sie in der Regel: * **Suchen**, um eine Frage schnell zu finden. * **Aktivieren/Deaktivieren**, um Einträge anzuzeigen oder auszublenden. * **Bearbeiten**, wenn sich Ihre Richtlinien ändern. > **Tipp:** Prüfen Sie diesen Bereich einmal im Monat. Die besten Einträge entstehen aus den häufigsten Supportfragen. # Features & Capabilities Source: https://support.callin.io/Automations/Whitelabel/Features Define the features that appear inside Subscription Plans so each plan can enable, limit, or configure what sub-accounts get. ## What this section is for **Features & Capabilities** is where a white-label account creates the “building blocks” that later show up when you create or edit a **Subscription Plan**. A simple way to think about it: * **Subscription Plans** = the tiers you sell (Starter, Pro, etc.) * **Features & Capabilities** = what each tier includes (enabled tools, numeric limits, or selectable options) If you don’t create features here first, your plan’s **Features** step will have nothing useful to configure. [Click here to open Features & Capabilities](https://app.callin.io/cms/features-capabilities)Screenshot: the Features & Capabilities page where you can search existing items or create a new Feature/Capability.
> **Important:** The exact URL can vary depending on your workspace setup. If the link doesn’t open, use the left sidebar: **Plans & Billing → Features & Capabilities**. ## How features are used in Subscription Plans When you create or edit a plan, you’ll reach a step called **Features** (the wording can vary by account). That step is where you assign values for the features you defined here. So the workflow is: 1. Create a feature (here) 2. Assign a value to that feature inside each plan (in Subscription Plans) 3. The plan’s value becomes what sub-accounts receive when they use that plan ## Create a Feature/Capability Click **Create Feature/Capability** and fill in these fields. ### Name A short label that will be shown inside plan configuration. Good examples: * **Minutes per month** * **Call recording** * **Voice selection** Bad examples (too vague): * **Minutes** * **Feature 1** * **Access** > **Tip:** Use names that read like a benefit or a clear rule. “Minutes per month” is clearer than “Minutes”. ### Description Optional, but recommended. Write a short sentence so your team knows exactly what this feature controls. Example: * “Monthly minutes included in the plan. Extra usage is billed separately.” ### How do plans grant this feature? This is the most important choice. It defines what kind of value plans will set. #### On / Off (toggle) Use when it’s simply enabled or disabled. Example: * Feature: **Call recording** * Starter plan: **Off** * Pro plan: **On** Best for: * Add-ons like “Call recording”, “Remove branding”, “Priority support” (if your setup includes it) #### Usage limit (limit) Use when the plan should set a numeric value, typically per billing period. Example: * Feature: **Minutes per month** * Starter plan: **400** * Pro plan: **1,000** Best for: * Minutes, seats, number of agents, number of phone numbers, or any “X per month” style rule (depending on what your account supports) #### Access with options (capability) Use when the plan should unlock one of several options. Example: * Feature: **Voice selection** * Starter plan: **Basic voices** * Pro plan: **Premium voices** Best for: * “Choose one of these packs” / “Choose a level” type entitlements > **Common mistake:** Picking **toggle** for something that should be a number (like minutes). If it can vary by plan, it usually belongs as a **limit**. ### Category Categories help you keep plan configuration tidy. When plans display features, they’re often grouped by category. Practical categories: * **Limits** (minutes, seats, usage caps) * **Add-ons** (recording, branded portal, etc.) * **Capabilities** (voice packs, routing modes, integrations—depending on what you offer) > **Tip:** Keep categories consistent across features. If you create “Limit” and “Limits” you’ll end up with messy grouping. ## Practical example (realistic setup) Imagine you sell two tiers to your sub-accounts: * **Starter**: 400 minutes/month for a fixed price * **Pro**: 1,000 minutes/month + call recording Create these features in **Features & Capabilities**: 1. **Minutes per month** → **Usage limit (limit)**\ Description: “Monthly minutes included in the plan.” 2. **Call recording** → **On / Off (toggle)**\ Description: “Enables call recording for calls handled by the assistant.” Then, in **Subscription Plans**: * Starter plan: * Minutes per month = **400** * Call recording = **Off** * Pro plan: * Minutes per month = **1,000** * Call recording = **On** This way, sub-accounts immediately understand what changes between tiers, and your pricing becomes easier to justify. ## Edit an existing Feature/Capability From the list, open the feature to edit its: * **Name** and **Description** * Feature type (toggle / limit / capability) * **Category** > **Important:** Changing a feature’s type after it’s used in plans can impact how plans store or display that value. What happens can vary depending on your account setup—if you’re unsure, create a new feature and migrate plans to it. # Funciones y capacidades Source: https://support.callin.io/Automations/Whitelabel/Features-copied-1 Define los elementos que aparecerán dentro de los planes de suscripción para que cada plan pueda activar, limitar o configurar lo que reciben las subcuentas. ## Para qué sirve esta sección **Funciones y capacidades** es el lugar donde una cuenta de marca blanca define qué puede incluir un plan de suscripción. Una forma sencilla de verlo: * **Planes de suscripción** = los niveles que vendes (por ejemplo, Básico vs. Premium) * **Funciones y capacidades** = lo que incluye cada nivel (herramientas activadas, límites numéricos u opciones seleccionables) Cuando creas o editas un plan, más adelante asignarás valores a estos elementos en el paso de **Funciones** del plan. [Haz clic aquí para abrir Funciones y capacidades](https://app.callin.io/cms/features-capabilities)Captura: página de Funciones y capacidades, donde puedes buscar elementos existentes o crear uno nuevo.
> **Importante:** Los nombres exactos y las opciones disponibles pueden variar según tu cuenta y tu plan. ## Cómo se relaciona con los planes de suscripción El flujo habitual es: 1. Creas las funciones/capacidades aquí 2. Creas (o editas) un plan de suscripción 3. En el paso de **Funciones** del plan, asignas el valor de cada función/capacidad Ese valor es el que determina qué recibe cada subcuenta cuando usa ese plan. ## Crear una función o capacidad Pulsa el botón para crear y completa estos campos. ### Nombre Es la etiqueta que verás después dentro del plan. Buenos ejemplos: * **Minutos por mes** * **Grabación de llamadas** * **Selección de voz** Malos ejemplos (demasiado vagos): * **Minutos** * **Función 1** * **Acceso** > **Consejo:** Usa nombres que se lean como una regla clara. “Minutos por mes” es más claro que “Minutos”. ### Descripción Opcional, pero recomendable. Escribe una frase para que cualquiera entienda qué controla ese elemento. Ejemplo: * “Minutos mensuales incluidos en el plan. El uso extra se cobra aparte.” ### Cómo conceden los planes esta función Esta elección define el tipo de valor que podrás configurar dentro de cada plan. #### Activar / Desactivar (interruptor) Úsalo cuando sea simplemente sí o no. Ejemplo: * Función: **Grabación de llamadas** * Plan Básico: **Desactivado** * Plan Pro: **Activado** Ideal para: * Extras que se permiten o no se permiten, sin números. #### Límite de uso (límite) Úsalo cuando el plan deba fijar un número por periodo de facturación. Ejemplo: * Función: **Minutos por mes** * Plan Básico: **400** * Plan Pro: **1.000** Ideal para: * Minutos, asientos, número de agentes o cualquier “X por mes” (según lo que soporte tu cuenta). #### Acceso con opciones (capacidad) Úsalo cuando el plan deba habilitar una opción entre varias. Ejemplo: * Función: **Selección de voz** * Plan Básico: **Voces estándar** * Plan Pro: **Voces premium** Ideal para: * Paquetes o niveles seleccionables (por ejemplo, “estándar” vs. “premium”). > **Error común:** Elegir un interruptor para algo que debería ser numérico (como minutos). Si puede variar entre planes, normalmente es un **límite**. ### Categoría Las categorías sirven para agrupar elementos y mantener ordenada la configuración del plan. Ejemplos de categorías prácticas: * **Límites** (minutos, topes de uso) * **Extras** (funciones opcionales) * **Capacidades** (paquetes u opciones) > **Consejo:** Mantén las categorías consistentes. Si creas “Límite” y “Límites”, terminarás con agrupaciones duplicadas. ## Ejemplo práctico (configuración realista) Imagina que vendes dos niveles: * **Básico**: 400 minutos al mes * **Pro**: 1.000 minutos al mes + grabación de llamadas Crea estas funciones en **Funciones y capacidades**: 1. **Minutos por mes** → **Límite de uso**\ Descripción: “Minutos mensuales incluidos en el plan.” 2. **Grabación de llamadas** → **Activar / Desactivar**\ Descripción: “Activa la grabación de llamadas gestionadas por el asistente.” Luego, en tus planes: * Plan Básico: * Minutos por mes = **400** * Grabación de llamadas = **Desactivado** * Plan Pro: * Minutos por mes = **1.000** * Grabación de llamadas = **Activado** Así, las subcuentas entienden al instante qué cambia entre niveles. ## Editar una función o capacidad existente Desde el listado, abre el elemento para modificar: * **Nombre** y **Descripción** * El tipo (interruptor / límite / opciones) * La **Categoría** > **Importante:** Cambiar el tipo de un elemento después de usarlo en planes puede afectar a cómo se guarda o se muestra su valor. Si no estás seguro, crea un elemento nuevo y actualiza los planes para usarlo. # Fonctionnalités et capacités Source: https://support.callin.io/Automations/Whitelabel/Features-copied-2 Définissez les éléments qui apparaîtront dans les forfaits d’abonnement afin que chaque forfait puisse activer, limiter ou configurer ce que reçoivent les sous-comptes. ## À quoi sert cette section **Fonctionnalités et capacités** est l’endroit où un compte en marque blanche définit ce qu’un forfait d’abonnement peut inclure. Une manière simple de le comprendre : * **Forfaits d’abonnement** = les niveaux que vous vendez (par exemple, Essentiel vs. Premium) * **Fonctionnalités et capacités** = ce que chaque niveau inclut (outils activés, limites numériques ou options sélectionnables) Lorsque vous créez ou modifiez un forfait, vous attribuerez ensuite des valeurs à ces éléments dans l’étape **Fonctionnalités** du forfait. [Cliquez ici pour ouvrir Fonctionnalités et capacités](https://app.callin.io/cms/features-capabilities)Capture : page Fonctionnalités et capacités, où vous pouvez rechercher des éléments existants ou en créer un nouveau.
> **Important :** Les libellés exacts et les options disponibles peuvent varier selon votre compte et votre formule. ## Comment cela se relie aux forfaits d’abonnement Le flux habituel est : 1. Vous créez les fonctionnalités/capacités ici 2. Vous créez (ou modifiez) un forfait d’abonnement 3. Dans l’étape **Fonctionnalités** du forfait, vous attribuez une valeur à chaque élément Cette valeur détermine ce que reçoit un sous-compte lorsqu’il utilise ce forfait. ## Créer une fonctionnalité ou une capacité Cliquez sur le bouton de création, puis renseignez les champs suivants. ### Nom C’est l’étiquette que vous verrez ensuite dans la configuration du forfait. Bons exemples : * **Minutes par mois** * **Enregistrement des appels** * **Choix de la voix** Mauvais exemples (trop vagues) : * **Minutes** * **Fonction 1** * **Accès** > **Astuce :** Utilisez des noms qui ressemblent à une règle claire. « Minutes par mois » est plus clair que « Minutes ». ### Description Optionnelle, mais recommandée. Écrivez une phrase qui explique exactement ce que l’élément contrôle. Exemple : * « Minutes mensuelles incluses dans le forfait. L’usage supplémentaire est facturé séparément. » ### Comment les forfaits accordent cette fonctionnalité Ce choix définit le type de valeur que vous configurerez ensuite dans chaque forfait. #### Activer / désactiver (interrupteur) À utiliser lorsque c’est simplement oui/non. Exemple : * Fonctionnalité : **Enregistrement des appels** * Forfait Essentiel : **Désactivé** * Forfait Pro : **Activé** Idéal pour : * Des options qui sont soit autorisées, soit non, sans valeur numérique. #### Limite d’usage (limite) À utiliser lorsque le forfait doit définir un nombre par période de facturation. Exemple : * Fonctionnalité : **Minutes par mois** * Forfait Essentiel : **400** * Forfait Pro : **1 000** Idéal pour : * Minutes, sièges, nombre d’agents, ou toute règle « X par mois » (selon ce que votre compte prend en charge). #### Accès avec options (capacité) À utiliser lorsque le forfait doit activer une option parmi plusieurs. Exemple : * Fonctionnalité : **Choix de la voix** * Forfait Essentiel : **Voix standard** * Forfait Pro : **Voix premium** Idéal pour : * Des packs ou niveaux sélectionnables (par exemple, « standard » vs. « premium »). > **Erreur fréquente :** Choisir un interrupteur pour un élément qui devrait être numérique (comme les minutes). S’il varie selon le forfait, c’est généralement une **limite**. ### Catégorie Les catégories servent à regrouper les éléments et à garder la configuration du forfait claire. Exemples de catégories pratiques : * **Limites** (minutes, plafonds d’usage) * **Options** (fonctionnalités facultatives) * **Capacités** (packs ou options) > **Astuce :** Gardez des catégories cohérentes. Si vous créez « Limite » et « Limites », vous obtiendrez des regroupements en double. ## Exemple concret (configuration réaliste) Imaginez deux niveaux : * **Essentiel** : 400 minutes par mois * **Pro** : 1 000 minutes par mois + enregistrement des appels Créez ces éléments dans **Fonctionnalités et capacités** : 1. **Minutes par mois** → **Limite d’usage**\ Description : « Minutes mensuelles incluses dans le forfait. » 2. **Enregistrement des appels** → **Activer / désactiver**\ Description : « Active l’enregistrement des appels gérés par l’assistant. » Puis, dans vos forfaits : * Forfait Essentiel : * Minutes par mois = **400** * Enregistrement des appels = **Désactivé** * Forfait Pro : * Minutes par mois = **1 000** * Enregistrement des appels = **Activé** Ainsi, les sous-comptes comprennent immédiatement ce qui change entre les niveaux. ## Modifier une fonctionnalité ou une capacité existante Depuis la liste, ouvrez l’élément pour modifier : * **Nom** et **Description** * Le type (interrupteur / limite / options) * La **Catégorie** > **Important :** Modifier le type d’un élément après l’avoir utilisé dans des forfaits peut changer la manière dont sa valeur est enregistrée ou affichée. En cas de doute, créez un nouvel élément et mettez à jour les forfaits pour l’utiliser. # Funzionalità e capacità Source: https://support.callin.io/Automations/Whitelabel/Features-copied-3 Definisci gli elementi che compariranno nei piani di abbonamento, così ogni piano può attivare, limitare o configurare ciò che ricevono i sotto-account. ## A cosa serve questa sezione **Funzionalità e capacità** è il punto in cui un account in white label definisce cosa può includere un piano di abbonamento. Un modo semplice per capirlo: * **Piani di abbonamento** = i livelli che vendi (ad esempio, Base vs. Premium) * **Funzionalità e capacità** = cosa include ogni livello (strumenti attivati, limiti numerici o opzioni selezionabili) Quando crei o modifichi un piano, assegnerai poi i valori di questi elementi nella fase **Funzionalità** del piano. [Fai clic qui per aprire Funzionalità e capacità](https://app.callin.io/cms/features-capabilities)Schermata: pagina Funzionalità e capacità, dove puoi cercare elementi esistenti o crearne uno nuovo.
> **Importante:** Le diciture esatte e le opzioni disponibili possono variare in base al tuo account e al tuo piano. ## Come si collega ai piani di abbonamento Il flusso tipico è: 1. Crei qui funzionalità/capacità 2. Crei (o modifichi) un piano di abbonamento 3. Nella fase **Funzionalità** del piano, assegni un valore a ciascun elemento Quel valore determina cosa riceve un sotto-account quando utilizza il piano. ## Creare una funzionalità o una capacità Premi il pulsante di creazione e compila i campi seguenti. ### Nome È l’etichetta che vedrai poi nella configurazione del piano. Buoni esempi: * **Minuti al mese** * **Registrazione delle chiamate** * **Selezione della voce** Esempi da evitare (troppo vaghi): * **Minuti** * **Funzione 1** * **Accesso** > **Consiglio:** Usa nomi che sembrano una regola chiara. “Minuti al mese” è più chiaro di “Minuti”. ### Descrizione Facoltativa, ma consigliata. Scrivi una frase che spieghi esattamente cosa controlla l’elemento. Esempio: * “Minuti mensili inclusi nel piano. L’uso extra viene addebitato separatamente.” ### In che modo i piani concedono questa funzionalità Questa scelta definisce il tipo di valore che configurerai in ogni piano. #### Attiva / disattiva (interruttore) Usalo quando è semplicemente sì/no. Esempio: * Funzionalità: **Registrazione delle chiamate** * Piano Base: **Disattivata** * Piano Pro: **Attivata** Ideale per: * Opzioni che si abilitano o disabilitano senza numeri. #### Limite di utilizzo (limite) Usalo quando il piano deve impostare un numero per periodo di fatturazione. Esempio: * Funzionalità: **Minuti al mese** * Piano Base: **400** * Piano Pro: **1.000** Ideale per: * Minuti, posti, numero di agenti o qualsiasi regola “X al mese” (in base a ciò che supporta il tuo account). #### Accesso con opzioni (capacità) Usalo quando il piano deve sbloccare una scelta tra più opzioni. Esempio: * Funzionalità: **Selezione della voce** * Piano Base: **Voci standard** * Piano Pro: **Voci premium** Ideale per: * Pacchetti o livelli selezionabili (ad esempio, “standard” vs. “premium”). > **Errore comune:** Scegliere un interruttore per qualcosa che dovrebbe essere numerico (come i minuti). Se varia tra piani, di solito è un **limite**. ### Categoria Le categorie servono a raggruppare gli elementi e mantenere ordinata la configurazione del piano. Esempi di categorie utili: * **Limiti** (minuti, tetti di utilizzo) * **Extra** (opzioni aggiuntive) * **Capacità** (pacchetti o scelte) > **Consiglio:** Mantieni le categorie coerenti. Se crei “Limite” e “Limiti”, ti ritroverai con raggruppamenti duplicati. ## Esempio pratico (configurazione realistica) Immagina due livelli: * **Base**: 400 minuti al mese * **Pro**: 1.000 minuti al mese + registrazione delle chiamate Crea questi elementi in **Funzionalità e capacità**: 1. **Minuti al mese** → **Limite di utilizzo**\ Descrizione: “Minuti mensili inclusi nel piano.” 2. **Registrazione delle chiamate** → **Attiva / disattiva**\ Descrizione: “Attiva la registrazione delle chiamate gestite dall’assistente.” Poi, nei tuoi piani: * Piano Base: * Minuti al mese = **400** * Registrazione delle chiamate = **Disattivata** * Piano Pro: * Minuti al mese = **1.000** * Registrazione delle chiamate = **Attivata** In questo modo, i sotto-account capiscono subito cosa cambia tra i livelli. ## Modificare una funzionalità o una capacità esistente Dall’elenco, apri l’elemento per modificare: * **Nome** e **Descrizione** * Il tipo (interruttore / limite / opzioni) * La **Categoria** > **Importante:** Cambiare il tipo di un elemento dopo averlo usato nei piani può influire su come il valore viene salvato o mostrato. Se hai dubbi, crea un nuovo elemento e aggiorna i piani per utilizzarlo. # Funktionen und Fähigkeiten Source: https://support.callin.io/Automations/Whitelabel/Features-copied-4 Definieren Sie die Elemente, die in Abonnementplänen erscheinen, damit jeder Plan festlegen kann, was Unterkonten erhalten. ## Wofür dieser Bereich gedacht ist **Funktionen und Fähigkeiten** ist der Bereich, in dem ein White-Label-Konto festlegt, was ein Abonnementplan enthalten kann. Eine einfache Einordnung: * **Abonnementpläne** = die Stufen, die Sie verkaufen (zum Beispiel Basis vs. Premium) * **Funktionen und Fähigkeiten** = was jede Stufe enthält (aktivierte Werkzeuge, Zahlenlimits oder auswählbare Optionen) Wenn Sie einen Plan erstellen oder bearbeiten, vergeben Sie die Werte dieser Elemente später im Schritt **Funktionen** des Plans. [Klicken Sie hier, um Funktionen und Fähigkeiten zu öffnen](https://app.callin.io/cms/features-capabilities)Screenshot: Seite Funktionen und Fähigkeiten, auf der Sie bestehende Elemente suchen oder ein neues erstellen können.
> **Wichtig:** Die genauen Bezeichnungen und verfügbaren Optionen können je nach Konto und Tarif variieren. ## Wie das mit Abonnementplänen zusammenhängt Der typische Ablauf ist: 1. Sie erstellen hier Funktionen/Fähigkeiten 2. Sie erstellen (oder bearbeiten) einen Abonnementplan 3. Im Schritt **Funktionen** des Plans vergeben Sie für jedes Element einen Wert Dieser Wert bestimmt, was ein Unterkonto erhält, wenn es den Plan nutzt. ## Eine Funktion oder Fähigkeit erstellen Klicken Sie auf die Erstellungsschaltfläche und füllen Sie die folgenden Felder aus. ### Name Das ist die Bezeichnung, die später in der Plankonfiguration angezeigt wird. Gute Beispiele: * **Minuten pro Monat** * **Anrufaufzeichnung** * **Sprachauswahl** Ungünstige Beispiele (zu unklar): * **Minuten** * **Funktion 1** * **Zugriff** > **Tipp:** Verwenden Sie Namen, die wie eine klare Regel wirken. „Minuten pro Monat“ ist verständlicher als „Minuten“. ### Beschreibung Optional, aber empfohlen. Ein Satz, der genau erklärt, was das Element steuert. Beispiel: * „Monatlich im Plan enthaltene Minuten. Zusätzliche Nutzung wird separat berechnet.“ ### Wie Pläne diese Funktion bereitstellen Diese Auswahl legt fest, welche Art von Wert Sie in den Plänen einstellen. #### Aktivieren / deaktivieren (Schalter) Verwenden Sie das, wenn es nur ja/nein ist. Beispiel: * Funktion: **Anrufaufzeichnung** * Plan Basis: **Deaktiviert** * Plan Pro: **Aktiviert** Geeignet für: * Optionen, die einfach ein- oder ausgeschaltet werden. #### Nutzungslimit (Limit) Verwenden Sie das, wenn der Plan eine Zahl pro Abrechnungszeitraum festlegen soll. Beispiel: * Funktion: **Minuten pro Monat** * Plan Basis: **400** * Plan Pro: **1.000** Geeignet für: * Minuten, Plätze, Anzahl Agenten oder jede Regel „X pro Monat“ (abhängig von den Möglichkeiten Ihres Kontos). #### Zugriff mit Optionen (Auswahl) Verwenden Sie das, wenn der Plan eine Auswahl aus mehreren Optionen freischalten soll. Beispiel: * Funktion: **Sprachauswahl** * Plan Basis: **Standardstimmen** * Plan Pro: **Premiumstimmen** Geeignet für: * Pakete oder wählbare Stufen (zum Beispiel „Standard“ vs. „Premium“). > **Häufiger Fehler:** Einen Schalter wählen, obwohl eine Zahl nötig wäre (wie bei Minuten). Wenn es je Plan unterschiedlich sein soll, ist es in der Regel ein **Limit**. ### Kategorie Kategorien helfen dabei, Elemente zu gruppieren und die Plankonfiguration übersichtlich zu halten. Praktische Kategorien: * **Limits** (Minuten, Nutzungsobergrenzen) * **Extras** (zusätzliche Optionen) * **Fähigkeiten** (Pakete oder Auswahlen) > **Tipp:** Halten Sie Kategorien konsistent. Wenn Sie „Limit“ und „Limits“ mischen, entstehen doppelte Gruppen. ## Praxisbeispiel (realistische Einrichtung) Stellen Sie sich zwei Stufen vor: * **Basis**: 400 Minuten pro Monat * **Pro**: 1.000 Minuten pro Monat + Anrufaufzeichnung Erstellen Sie diese Elemente in **Funktionen und Fähigkeiten**: 1. **Minuten pro Monat** → **Nutzungslimit**\ Beschreibung: „Monatlich im Plan enthaltene Minuten.“ 2. **Anrufaufzeichnung** → **Aktivieren / deaktivieren**\ Beschreibung: „Aktiviert die Aufzeichnung von Anrufen, die vom Assistenten bearbeitet werden.“ Dann in Ihren Plänen: * Plan Basis: * Minuten pro Monat = **400** * Anrufaufzeichnung = **Deaktiviert** * Plan Pro: * Minuten pro Monat = **1.000** * Anrufaufzeichnung = **Aktiviert** So verstehen Unterkonten sofort, was sich zwischen den Stufen unterscheidet. ## Eine bestehende Funktion oder Fähigkeit bearbeiten Öffnen Sie in der Liste das Element, um Folgendes zu ändern: * **Name** und **Beschreibung** * Den Typ (Schalter / Limit / Optionen) * Die **Kategorie** > **Wichtig:** Wenn Sie den Typ eines Elements ändern, nachdem es bereits in Plänen verwendet wird, kann das beeinflussen, wie Werte gespeichert oder angezeigt werden. Wenn Sie unsicher sind, erstellen Sie ein neues Element und stellen Sie die Pläne darauf um. # Guides Source: https://support.callin.io/Automations/Whitelabel/Guide Add your own help links so sub-accounts can access your documentation from inside the app. ## What this section is for **Guides** lets you add **your own documentation links** for your customers inside Callin. This is useful if you want your sub-accounts to open help resources directly from the app, such as: * A knowledge base (for example, Mintlify) * A Notion workspace * A help center on your website * A Google Doc or internal wiki > **Important:** Sub-accounts won’t see Callin’s official documentation here. Callin’s official docs include Callin branding, so for white-label setups you should publish **your own** documentation and link it in this section. [Click here to open Guides](https://app.callin.io/cms/guides)Screenshot: the Guides list where you can add new documentation links and manage existing ones.
## How it works Each item you add here is a **link** that can appear to your sub-accounts (depending on whether it’s active). The goal is simple: when someone needs help, they click the guide and are taken to the URL you provided. A guide typically includes: * A **title** (what users see in the navigation) * A **short description** (what the link is about) * A **URL** (where the user is sent) * An **active** toggle (to show or hide it) > **Tip:** Use clear titles like “Video Tutorials”, “Getting Started”, “FAQs”, or “Troubleshooting”. ## Add a new guide link 1. Click **Add New**. 2. Fill in the fields: * **Title**: the name users will recognize (for example, “Help Center”). * **Description**: a short explanation (for example, “Step-by-step tutorials and FAQs”). * **URL**: the full link users should open (for example, your Mintlify site or your own support site). 3. Turn **Active** on if you want it visible to sub-accounts right away. 4. Click **Save**. ### Practical example If your documentation is hosted on Mintlify, you could create: * Title: **Documentation** * Description: “Guides for setup, billing, and best practices.” * URL: “Your Mintlify documentation URL” * Active: **On** Then, when a customer asks “Where do I find the setup guide?”, you can point them to the link you published here. ## Manage existing guides From the guides list you can usually: * **Search** to find a guide quickly. * **Edit** a guide to update its title, description, or URL. * **Disable/deactivate** a guide if you no longer want it visible. > **Common mistake:** Linking to a private page. Make sure the URL is accessible to your customers (or clearly explain if they need a login). # Guías Source: https://support.callin.io/Automations/Whitelabel/Guide-copied-1 Añade tus propios enlaces de ayuda para que las subcuentas puedan acceder a tu documentación desde dentro de la app. ## Para qué sirve esta sección **Guías** te permite añadir **enlaces a tu propia documentación** para tus clientes dentro de Callin. Esto es útil si quieres que tus subcuentas abran recursos de ayuda directamente desde la app, por ejemplo: * Una base de conocimiento (por ejemplo, Mintlify) * Un espacio en Notion * Un centro de ayuda en tu web * Un documento de Google o una wiki interna > **Importante:** Las subcuentas no verán aquí la documentación oficial de Callin. La documentación oficial de Callin lleva el branding de Callin, así que en un entorno de marca blanca lo habitual es publicar **tu propia** documentación y enlazarla en esta sección. [Haz clic aquí para abrir Guías](https://app.callin.io/cms/guides)Captura: listado de Guías, donde puedes añadir enlaces de documentación y gestionar los existentes.
## Cómo funciona Cada elemento que añades aquí es un **enlace** que puede mostrarse a tus subcuentas (según esté activo o no). La idea es simple: cuando alguien necesita ayuda, abre la guía y se le lleva a la URL que definiste. Una guía suele incluir: * Un **título** (lo que el usuario ve en la navegación) * Una **descripción breve** (de qué trata el enlace) * Una **URL** (a dónde se envía al usuario) * Un interruptor de **activo** (para mostrarla u ocultarla) > **Consejo:** Usa títulos claros como “Tutoriales en vídeo”, “Primeros pasos”, “Preguntas frecuentes” o “Solución de problemas”. ## Añadir una nueva guía 1. Pulsa el botón para **añadir una guía nueva**. 2. Rellena los campos: * **Título**: el nombre que el usuario reconocerá (por ejemplo, “Centro de ayuda”). * **Descripción**: una frase corta (por ejemplo, “Tutoriales paso a paso y preguntas frecuentes”). * **URL**: el enlace completo que debe abrir el usuario (por ejemplo, tu sitio de Mintlify o tu web de soporte). 3. Activa la opción de **activo** si quieres que se vea de inmediato para las subcuentas. 4. Pulsa **guardar**. ### Ejemplo práctico Si tu documentación está en Mintlify, podrías crear: * Título: **Documentación** * Descripción: “Guías de configuración, facturación y buenas prácticas.” * URL: “La URL de tu documentación en Mintlify” * Activo: **Sí** Así, cuando un cliente pregunte “¿Dónde está la guía de configuración?”, podrás dirigirlo al enlace que publicaste aquí. ## Gestionar guías existentes Desde el listado normalmente puedes: * **Buscar** para encontrar una guía rápidamente. * **Editar** una guía para cambiar título, descripción o URL. * **Desactivar** una guía si ya no quieres que sea visible. > **Error común:** Enlazar a una página privada. Asegúrate de que la URL sea accesible para tus clientes (o deja claro si necesitan iniciar sesión). # Guides Source: https://support.callin.io/Automations/Whitelabel/Guide-copied-2 Ajoutez vos propres liens d’aide afin que les sous-comptes puissent accéder à votre documentation depuis l’application. ## À quoi sert cette section La section **Guides** vous permet d’ajouter **des liens vers votre propre documentation** pour vos clients, directement dans Callin. C’est utile si vous voulez que vos sous-comptes ouvrent des ressources d’aide depuis l’application, par exemple : * Une base de connaissances (par exemple, Mintlify) * Un espace Notion * Un centre d’aide sur votre site web * Un document Google ou un wiki interne > **Important :** Les sous-comptes ne verront pas ici la documentation officielle de Callin. La documentation officielle de Callin inclut le branding Callin ; pour une configuration en marque blanche, l’approche recommandée est donc de publier **votre propre** documentation et de l’ajouter dans cette section. [Cliquez ici pour ouvrir Guides](https://app.callin.io/cms/guides)Capture : liste des Guides, où vous pouvez ajouter des liens de documentation et gérer ceux qui existent déjà.
## Comment ça fonctionne Chaque élément que vous ajoutez ici est un **lien** qui peut être affiché à vos sous-comptes (selon qu’il soit activé ou non). L’idée est simple : lorsqu’un utilisateur a besoin d’aide, il ouvre un guide et il est redirigé vers l’URL que vous avez fournie. Un guide inclut généralement : * Un **titre** (ce que l’utilisateur voit dans la navigation) * Une **description courte** (de quoi parle le lien) * Une **URL** (où l’utilisateur est envoyé) * Un statut **actif** (pour l’afficher ou le masquer) > **Astuce :** Utilisez des titres explicites comme « Tutoriels vidéo », « Bien démarrer », « FAQ » ou « Dépannage ». ## Ajouter un nouveau lien de guide 1. Cliquez sur le bouton pour **ajouter un nouveau guide**. 2. Renseignez les champs : * **Titre** : un nom que vos utilisateurs reconnaissent (par exemple « Centre d’aide »). * **Description** : une phrase courte (par exemple « Tutoriels pas à pas et FAQ »). * **URL** : le lien complet à ouvrir (par exemple votre site Mintlify ou votre site de support). 3. Activez le guide si vous voulez qu’il soit visible immédiatement par les sous-comptes. 4. Enregistrez. ### Exemple concret Si votre documentation est hébergée sur Mintlify, vous pourriez créer : * Titre : **Documentation** * Description : « Guides de configuration, de facturation et bonnes pratiques. » * URL : « L’URL de votre documentation Mintlify » * Actif : **Oui** Ainsi, lorsqu’un client demande « Où est le guide de configuration ? », vous pouvez l’orienter vers le lien publié ici. ## Gérer les guides existants Depuis la liste, vous pouvez généralement : * **Rechercher** un guide pour le retrouver rapidement. * **Modifier** un guide (titre, description ou URL). * **Désactiver** un guide si vous ne voulez plus l’afficher. > **Erreur fréquente :** Lier une page privée. Assurez-vous que l’URL est accessible à vos clients (ou précisez clairement qu’une connexion est nécessaire). # Guide Source: https://support.callin.io/Automations/Whitelabel/Guide-copied-3 Aggiungi i tuoi link di supporto così i sotto-account possono accedere alla tua documentazione direttamente dall’app. ## A cosa serve questa sezione La sezione **Guide** ti permette di aggiungere **link alla tua documentazione** per i tuoi clienti direttamente in Callin. È utile se vuoi che i sotto-account aprano risorse di aiuto dall’interno dell’app, ad esempio: * Una knowledge base (per esempio, Mintlify) * Uno spazio Notion * Un centro assistenza sul tuo sito * Un documento Google o una wiki interna > **Importante:** I sotto-account non vedranno qui la documentazione ufficiale di Callin. La documentazione ufficiale di Callin include il branding Callin; per un setup in white label è quindi consigliato pubblicare **la tua** documentazione e inserirla in questa sezione. [Fai clic qui per aprire Guide](https://app.callin.io/cms/guides)Schermata: elenco delle Guide, dove puoi aggiungere link di documentazione e gestire quelli esistenti.
## Come funziona Ogni elemento che aggiungi qui è un **link** che può essere mostrato ai tuoi sotto-account (in base al fatto che sia attivo o meno). L’idea è semplice: quando qualcuno ha bisogno di aiuto, apre la guida e viene portato all’URL che hai indicato. In genere una guida include: * Un **titolo** (ciò che l’utente vede nella navigazione) * Una **descrizione breve** (di cosa tratta il link) * Un **URL** (dove viene inviato l’utente) * Un’opzione **attivo** (per mostrarla o nasconderla) > **Consiglio:** Usa titoli chiari come “Tutorial video”, “Primi passi”, “FAQ” o “Risoluzione problemi”. ## Aggiungere una nuova guida 1. Premi il pulsante per **aggiungere una nuova guida**. 2. Compila i campi: * **Titolo**: un nome riconoscibile (per esempio “Centro assistenza”). * **Descrizione**: una frase breve (per esempio “Tutorial passo-passo e FAQ”). * **URL**: il link completo da aprire (per esempio il tuo sito Mintlify o il tuo sito di supporto). 3. Attiva la guida se vuoi che sia visibile subito ai sotto-account. 4. Salva. ### Esempio pratico Se la tua documentazione è su Mintlify, potresti creare: * Titolo: **Documentazione** * Descrizione: “Guide di configurazione, fatturazione e buone pratiche.” * URL: “L’URL della tua documentazione Mintlify” * Attivo: **Sì** Così, quando un cliente chiede “Dove trovo la guida di configurazione?”, puoi indirizzarlo al link pubblicato qui. ## Gestire le guide esistenti Dall’elenco, in genere puoi: * **Cercare** una guida per trovarla rapidamente. * **Modificare** una guida (titolo, descrizione o URL). * **Disattivare** una guida se non vuoi più mostrarla. > **Errore comune:** Collegare una pagina privata. Assicurati che l’URL sia accessibile ai clienti (oppure chiarisci che è necessario effettuare l’accesso). # Anleitungen Source: https://support.callin.io/Automations/Whitelabel/Guide-copied-4 Fügen Sie eigene Hilfe-Links hinzu, damit Unterkonten Ihre Dokumentation direkt in der App öffnen können. ## Wofür dieser Bereich gedacht ist Der Bereich **Anleitungen** ermöglicht es Ihnen, **Links zu Ihrer eigenen Dokumentation** für Ihre Kundschaft direkt in Callin zu hinterlegen. Das ist hilfreich, wenn Unterkonten Hilferessourcen direkt aus der App öffnen sollen, zum Beispiel: * Eine Wissensdatenbank (zum Beispiel Mintlify) * Einen Notion-Bereich * Ein Hilfe-Center auf Ihrer Website * Ein Google-Dokument oder ein internes Wiki > **Wichtig:** Unterkonten sehen hier nicht die offizielle Callin-Dokumentation. Die offizielle Callin-Dokumentation enthält Callin-Branding; für White-Label-Setups sollten Sie daher **Ihre eigene** Dokumentation veröffentlichen und hier verlinken. [Klicken Sie hier, um Anleitungen zu öffnen](https://app.callin.io/cms/guides)Screenshot: Liste der Anleitungen, in der Sie Dokumentations-Links hinzufügen und bestehende verwalten können.
## So funktioniert es Jeder Eintrag, den Sie hier hinzufügen, ist ein **Link**, der Unterkonten angezeigt werden kann (je nachdem, ob er aktiviert ist). Die Idee ist einfach: Wenn jemand Hilfe braucht, öffnet er die Anleitung und wird zur von Ihnen hinterlegten URL weitergeleitet. Eine Anleitung enthält typischerweise: * Einen **Titel** (was Nutzer in der Navigation sehen) * Eine **kurze Beschreibung** (worum es beim Link geht) * Eine **URL** (wohin weitergeleitet wird) * Einen **Aktiv-Status** (zum Ein- oder Ausblenden) > **Tipp:** Verwenden Sie klare Titel wie „Video-Tutorials“, „Erste Schritte“, „Häufige Fragen“ oder „Problemlösung“. ## Einen neuen Anleitungs-Link hinzufügen 1. Klicken Sie auf die Schaltfläche zum **Hinzufügen einer neuen Anleitung**. 2. Füllen Sie die Felder aus: * **Titel**: ein Name, den Nutzer sofort erkennen (zum Beispiel „Hilfe-Center“). * **Beschreibung**: ein kurzer Satz (zum Beispiel „Schritt-für-Schritt-Anleitungen und häufige Fragen“). * **URL**: der vollständige Link, der geöffnet werden soll (zum Beispiel Ihre Mintlify-Seite oder Ihre Support-Website). 3. Aktivieren Sie die Anleitung, wenn sie sofort für Unterkonten sichtbar sein soll. 4. Speichern Sie. ### Praxisbeispiel Wenn Ihre Dokumentation auf Mintlify liegt, könnten Sie anlegen: * Titel: **Dokumentation** * Beschreibung: „Anleitungen zu Einrichtung, Abrechnung und Best Practices.“ * URL: „Die URL Ihrer Mintlify-Dokumentation“ * Aktiv: **Ja** So können Sie bei der Frage „Wo finde ich die Einrichtungsanleitung?“ direkt auf den hier veröffentlichten Link verweisen. ## Bestehende Anleitungen verwalten In der Liste können Sie in der Regel: * **Suchen**, um eine Anleitung schnell zu finden. * Eine Anleitung **bearbeiten** (Titel, Beschreibung oder URL). * Eine Anleitung **deaktivieren**, wenn sie nicht mehr sichtbar sein soll. > **Häufiger Fehler:** Auf eine private Seite verlinken. Stellen Sie sicher, dass die URL für Ihre Kundschaft erreichbar ist (oder erklären Sie klar, dass ein Login erforderlich ist). # FAQs Source: https://support.callin.io/Automations/Whitelabel/Guide-copied-5 Créez et gérez les questions fréquentes que vos sous-comptes verront dans votre application en marque blanche. ## À quoi sert cette section La section **FAQ** vous permet de rédiger les questions les plus courantes de vos clients, avec des réponses claires qu’ils peuvent consulter immédiatement dans votre application. C’est particulièrement utile en marque blanche, car cela vous aide à : * Réduire les demandes répétitives au support. * Clarifier les règles de facturation et d’utilisation. * Expliquer le fonctionnement de vos offres avec des mots simples. > **Important :** Les sous-comptes ne verront pas ici la documentation officielle de Callin. Cette FAQ est destinée à **vos propres** réponses orientées client. [Cliquez ici pour ouvrir la section FAQ](https://app.callin.io/cms/faqs)Capture : liste des questions, avec recherche, ajout et gestion des éléments activés.
## Comment fonctionne la FAQ Chaque entrée de FAQ contient : * **Une question** (ce que l’utilisateur lit) * **Une réponse** (votre explication officielle) * Un statut **actif** (pour l’afficher ou la masquer) Lorsqu’une question est active, elle peut être visible par vos sous-comptes dans l’application (l’emplacement exact peut varier selon votre configuration). > **Astuce :** Gardez les réponses courtes et directes. Si un sujet est long, ajoutez plutôt un lien vers votre documentation dans la section **Guides**. ## Ajouter une nouvelle question 1. Cliquez sur **Ajouter une question**. 2. Renseignez : * **Question** : écrivez-la comme un client la formulerait. * **Réponse** : répondez clairement, en 3 à 6 lignes. 3. Laissez-la en **actif** si vous voulez qu’elle soit visible immédiatement. 4. Enregistrez. > **Erreur fréquente :** Écrire des réponses comme des notes internes. Une FAQ doit être facile à comprendre et éviter le jargon. ## Exemples à copier et adapter Voici des exemples réalistes (avec réponses) pour vous servir de base. ### Exemple 1 : Changer d’offre **Question :** Puis-je passer à une offre supérieure à tout moment ?\ **Réponse :** Oui. Vous pouvez passer à une offre supérieure quand vous le souhaitez. La nouvelle offre s’applique généralement au prochain cycle de facturation. Si certains éléments changent immédiatement, vous le verrez directement dans votre compte. ### Exemple 2 : Acheter des minutes supplémentaires **Question :** Puis-je acheter des minutes supplémentaires ?\ **Réponse :** Si votre offre autorise les minutes supplémentaires, vous pourrez en acheter lorsque vous atteignez votre quota inclus. Les minutes en plus sont facturées selon le tarif défini dans votre offre. ### Exemple 3 : Minutes non utilisées **Question :** Les minutes non utilisées sont-elles reportées au mois suivant ?\ **Réponse :** Dans la plupart des cas, les minutes ne sont pas reportées. Votre quota mensuel est réinitialisé au début de chaque cycle de facturation. (Cela peut varier selon les règles de votre offre.) ### Exemple 4 : Problème de paiement **Question :** Mon paiement a échoué, que se passe-t-il ?\ **Réponse :** En cas d’échec de paiement, votre abonnement peut passer dans un état « paiement en attente » jusqu’à résolution. Mettez à jour votre moyen de paiement puis réessayez. Si besoin, contactez votre support. > **Important :** Si vous mentionnez des règles comme le report des minutes ou des délais de grâce, vérifiez qu’elles correspondent à votre configuration de facturation. ## Gérer les questions existantes Depuis la liste, vous pouvez généralement : * **Rechercher** une question via la barre de recherche. * **Activer/Désactiver** une question pour l’afficher ou la masquer. * **Modifier** la question ou la réponse si vos règles évoluent. > **Astuce :** Passez en revue votre FAQ une fois par mois. Les meilleures FAQ évoluent en fonction des questions les plus fréquentes au support. # Integrations Source: https://support.callin.io/Automations/Whitelabel/Stripe Connect third-party services (payments, voice/SMS, email, live chat, and tracking) so your White Label app can run like a real product. ## What this page is for The **Integrations** page is where you connect your White Label app to the services that make day-to-day operations possible: * **Payments & subscriptions** (so you can charge customers) * **Voice and SMS** (so calling and messaging features work) * **Email sending** (so customers receive important emails) * **Live chat** (so customers can contact your team in real time) * **Marketing tracking** (so you can measure acquisition and conversions) Open it here: [Open Integrations](https://app.callin.io/cms/api-keys)Screenshot: the Integrations overview. Each card opens a setup panel with the exact fields you must fill in.
> **Important:** Card badges like **Connected** or **Required** reflect your current setup and can vary depending on your account and plan. ## Before you connect anything A few habits make integrations smoother (and safer): * **Use the right admin account** in each provider (Stripe, Twilio, etc.) so you can access keys and settings. * **Store keys securely** (treat them like passwords). * **Limit access** to people who need it. Don’t paste keys into shared docs or chats. > **Tip:** If an integration doesn’t work immediately, double-check for extra spaces at the beginning/end of a key before trying anything else. ## How connecting an integration works Most integrations follow the same pattern: 1. Click an integration card (for example **Twilio** or **SendGrid**). 2. A side panel opens with required fields (marked with `*`). 3. Copy the values from the provider dashboard. 4. Paste them into Callin and click **Save**. ## Stripe **What it’s for:** Stripe is used for **payment processing**. This is the integration that typically enables you to run a real subscription business: accepting payments, charging customers, and managing subscriptions. **When you need it:** If you plan to create paid plans and charge customers (monthly, yearly, etc.), Stripe is one of the first integrations to set up. ### What you’ll need (as shown in the panel) * **Secret Key**\* * **Webhook Secret**\* * **Webhook Secret Connect**\* * **Client ID**\*Screenshot: Stripe setup requires four values and is saved with the Save button.
### How to connect Stripe 1. Open the **Stripe** card. 2. In your Stripe dashboard, copy the required values. 3. Paste each value into the matching field in Callin. 4. Click **Save**. > **Important:** If you rotate keys or change webhook settings in Stripe later, you must come back here and update the values. ## Twilio **What it’s for:** Twilio powers **voice calls and SMS**. It’s the integration that makes calling and messaging features possible and also supports phone number management. **When you need it:** If your White Label includes inbound/outbound calls or SMS, Twilio will usually be essential—and may appear as **Required**. ### What you’ll need (as shown in the panel) * **Account SID**\* * **Auth Token**\*Screenshot: Twilio setup requires an Account SID and Auth Token.
### How to connect Twilio 1. Open the **Twilio** card. 2. From your Twilio dashboard, copy your **Account SID** and **Auth Token**. 3. Paste them into the corresponding fields in Callin. 4. Click **Save**. > **Tip:** If calling/SMS doesn’t work later, Twilio is the first integration to re-check. ## SendGrid **What it’s for:** SendGrid is used to **send emails** from your White Label app—especially automated and notification emails customers rely on (for example: confirmations and system messages). **When you need it:** If your customers should receive emails from your branded experience, set up SendGrid early. ### What you’ll need (as shown in the panel) * **API Key**\* * **Sender Email**\* (a verified sender email)Screenshot: SendGrid setup requires an API Key and a Sender Email.
### How to connect SendGrid 1. Open the **SendGrid** card. 2. Copy your **API Key** from SendGrid. 3. Enter a **Sender Email** that is verified in SendGrid. 4. Click **Save**. > **Common mistake:** Using a sender email that isn’t verified in SendGrid. If emails don’t send, verify the sender first. ## Intercom **What it’s for:** Intercom enables **live chat and customer support** inside your app. It’s a common option when you want customers to message your team without leaving the product. **When you need it:** If support and onboarding are part of what you sell, Intercom can make your White Label feel more “product-ready.” ### What you’ll need (as shown in the panel) * **App ID**\* (from Intercom workspace settings)Screenshot: Intercom setup requires an App ID.
### How to connect Intercom 1. Open the **Intercom** card. 2. Find your **App ID** in your Intercom workspace settings. 3. Paste it into Callin and click **Save**. > **Tip:** Use the Intercom workspace that matches your support team. That way, customer messages go to the right place. ## Brevo Chat **What it’s for:** Brevo Chat enables a **chat widget** for real-time customer conversations. The panel references Brevo (formerly Sendinblue), and the goal is to activate chat using a widget key. **When you need it:** If you prefer a lightweight chat widget experience (instead of Intercom), Brevo Chat is an option. ### What you’ll need (as shown in the panel) * **Chat Widget Key**\* (also described as a Chat Widget Key/API Key)Screenshot: Brevo Chat setup requires a Chat Widget Key.
### How to connect Brevo Chat 1. Open the **Brevo Chat** card. 2. In your Brevo dashboard, copy your **Chat Widget Key** (or Chat Widget Key/API Key). 3. Paste it into Callin and click **Save**. > **Important:** Keep the widget key private. Anyone with access could potentially use it in another environment. ## Analytics & Tracking API Keys **What it’s for:** This integration connects your White Label to **marketing and analytics tracking**. Based on the setup instructions shown in the panel, it supports: * **Google Ads** tracking via a Pixel ID * **Google Analytics (GA4)** tracking via a Measurement ID **Why this matters for White Label:** If you run paid campaigns or want clean attribution, you want conversions and traffic tracked for your brand so you can measure performance and ROI. ### What you’ll need (as shown in the panel) * **Google Ads Pixel ID** (example format: `AW-123456789`) * **Google Analytics Measurement ID (GA4)** (example format: `G-XXXXXXXXXX`)Screenshot: tracking setup where you paste your Google Ads and GA4 IDs and then save.
### How to connect tracking 1. Open **Analytics & Tracking API Keys**. 2. In Google Ads, copy your **Google Ads Pixel ID** and paste it into the matching field. 3. In Google Analytics (GA4), copy your **Measurement ID** and paste it into the GA4 field. 4. Click **Save**. ### What happens after you save (as described in the panel) * Tracking scripts can be injected using the IDs you entered (for this brand). * If a field is left empty, that provider’s script should not load for this brand. * Access to view/change these IDs is limited to users with the right level of access (as noted in the panel). > **Tip:** Keep a simple checklist for every new brand you launch: connect tracking early so you don’t lose attribution data during your first campaigns. # Integrationen Source: https://support.callin.io/Automations/Whitelabel/Stripe-copied-1 Verbinden Sie externe Dienste (Zahlungen, Voice/SMS, E-Mail, Live-Chat und Tracking), damit Ihr White Label wie ein vollständiges Produkt funktioniert. ## Wofür diese Seite da ist Auf der Seite **Integrationen** verbinden Sie Ihr White Label mit den Diensten, die den täglichen Betrieb ermöglichen: * **Zahlungen und Abonnements** (damit Sie Kunden abrechnen können) * **Voice und SMS** (damit Anrufe und Nachrichten funktionieren) * **E-Mail-Versand** (damit Kunden wichtige E-Mails erhalten) * **Live-Chat** (für Support in Echtzeit innerhalb der App) * **Marketing-Tracking** (um Akquise und Conversions zu messen) Öffnen Sie die Seite hier: [Integrationen öffnen](https://app.callin.io/cms/api-keys)Screenshot: Übersicht der Integrationen. Jede Kachel öffnet ein Panel mit den exakt auszufüllenden Feldern.
> **Wichtig:** Status-Badges auf den Kacheln (z. B. „verbunden“ oder „erforderlich“) zeigen Ihren aktuellen Stand an und können je nach Konto und Plan variieren. ## Bevor Sie etwas verbinden Ein paar Gewohnheiten machen Integrationen einfacher (und sicherer): * Nutzen Sie das **richtige Admin-Konto** bei jedem Anbieter (Stripe, Twilio usw.), damit Sie Schlüssel und Einstellungen sehen. * **Speichern Sie Schlüssel sicher** (behandeln Sie sie wie Passwörter). * **Begrenzen Sie den Zugriff** auf Personen, die ihn wirklich brauchen. Keine Schlüssel in geteilte Dokumente oder Chats kopieren. > **Tipp:** Wenn eine Integration nicht sofort funktioniert, prüfen Sie zuerst, ob beim Einfügen Leerzeichen am Anfang oder Ende eines Schlüssels entstanden sind. ## So funktioniert das Verbinden einer Integration Die meisten Integrationen folgen dem gleichen Ablauf: 1. Klicken Sie auf eine Kachel (z. B. Twilio oder SendGrid). 2. Rechts öffnet sich ein Panel mit Pflichtfeldern (mit `*` markiert). 3. Kopieren Sie die Werte aus dem Dashboard des Anbieters. 4. Fügen Sie die Werte in Callin ein und speichern Sie. ## Stripe **Wofür es ist:** Stripe wird für die **Zahlungsabwicklung** genutzt. Diese Integration ist typisch, wenn Sie ein Abo-Geschäft betreiben wollen: Zahlungen annehmen, Kunden belasten und Abonnements verwalten. **Wann Sie es brauchen:** Wenn Sie bezahlte Pläne anbieten und Kunden abrechnen (monatlich, jährlich usw.), richten Sie Stripe als eine der ersten Integrationen ein. ### Was Sie benötigen (wie im Panel angezeigt) * **Geheimer Schlüssel**\* * **Webhook-Secret**\* * **Webhook-Secret (Connect)**\* * **Client-ID**\*Screenshot: Stripe-Einrichtung mit vier erforderlichen Werten, die anschließend gespeichert werden.
### So verbinden Sie Stripe 1. Öffnen Sie die **Stripe**-Kachel. 2. Kopieren Sie die erforderlichen Werte aus Ihrem Stripe-Dashboard. 3. Fügen Sie jeden Wert in das passende Feld in Callin ein. 4. Speichern Sie. > **Wichtig:** Wenn Sie später Schlüssel rotieren oder Webhooks in Stripe ändern, müssen Sie hierher zurückkommen und die Werte aktualisieren. ## Twilio **Wofür es ist:** Twilio ermöglicht **Sprachanrufe und SMS**. Diese Integration macht Call- und Messaging-Funktionen möglich und unterstützt außerdem die Verwaltung von Telefonnummern. **Wann Sie es brauchen:** Wenn Ihr White Label eingehende/ausgehende Anrufe oder SMS umfasst, ist Twilio in der Regel unverzichtbar und kann als „erforderlich“ markiert sein. ### Was Sie benötigen (wie im Panel angezeigt) * **Account-SID**\* * **Authentifizierungs-Token**\*Screenshot: Twilio-Einrichtung mit Account-SID und Authentifizierungs-Token.
### So verbinden Sie Twilio 1. Öffnen Sie die **Twilio**-Kachel. 2. Suchen Sie in Ihrem Twilio-Dashboard die Account-SID und den Authentifizierungs-Token. 3. Fügen Sie beides in Callin ein. 4. Speichern Sie. > **Tipp:** Wenn Anrufe oder SMS später nicht funktionieren, ist Twilio oft die erste Integration, die Sie prüfen sollten. ## SendGrid **Wofür es ist:** SendGrid wird verwendet, um **E-Mails** aus Ihrem White Label zu versenden – insbesondere automatische E-Mails und Benachrichtigungen, auf die Kunden angewiesen sind (z. B. Systemnachrichten). **Wann Sie es brauchen:** Wenn Ihre gebrandete Erfahrung E-Mails an Kunden senden soll, richten Sie SendGrid früh ein. ### Was Sie benötigen (wie im Panel angezeigt) * **API-Schlüssel**\* * **Absender-E-Mail**\* (ein verifizierter Absender)Screenshot: SendGrid-Einrichtung mit API-Schlüssel und Absender-E-Mail.
### So verbinden Sie SendGrid 1. Öffnen Sie die **SendGrid**-Kachel. 2. Kopieren Sie Ihren API-Schlüssel aus SendGrid. 3. Tragen Sie eine Absender-E-Mail ein, die in SendGrid verifiziert ist. 4. Speichern Sie. > **Häufiger Fehler:** Eine Absenderadresse zu verwenden, die nicht verifiziert ist. Wenn keine E-Mails rausgehen, verifizieren Sie zuerst den Absender in SendGrid. ## Intercom **Wofür es ist:** Intercom ermöglicht **Live-Chat und Kundensupport** direkt in Ihrer App. Das ist hilfreich, wenn Kunden Ihr Team kontaktieren sollen, ohne das Produkt zu verlassen. **Wann Sie es brauchen:** Wenn Support und Onboarding Teil Ihres Angebots sind, lässt Intercom Ihr White Label „produktreifer“ wirken. ### Was Sie benötigen (wie im Panel angezeigt) * **App-ID**\* (aus den Einstellungen Ihres Intercom-Workspaces)Screenshot: Intercom-Einrichtung mit App-ID.
### So verbinden Sie Intercom 1. Öffnen Sie die **Intercom**-Kachel. 2. Finden Sie in Intercom die App-ID in den Workspace-Einstellungen. 3. Fügen Sie sie in Callin ein und speichern Sie. > **Tipp:** Verwenden Sie den Intercom-Workspace, der tatsächlich Ihr Support-Team bedient, damit Nachrichten im richtigen Postfach landen. ## Brevo Chat **Wofür es ist:** Brevo Chat aktiviert ein **Chat-Widget** für Gespräche in Echtzeit. Das Panel bezieht sich auf Brevo (früher Sendinblue); aktiviert wird es über einen Widget-Schlüssel. **Wann Sie es brauchen:** Wenn Sie statt Intercom ein leichteres Chat-Widget nutzen möchten, ist Brevo Chat eine Option. ### Was Sie benötigen (wie im Panel angezeigt) * **Chat-Widget-Schlüssel**\* (auch als Widget-/API-Schlüssel beschrieben)Screenshot: Brevo-Chat-Einrichtung mit dem Widget-Schlüssel.
### So verbinden Sie Brevo Chat 1. Öffnen Sie die **Brevo Chat**-Kachel. 2. Kopieren Sie in Brevo den Chat-Widget-Schlüssel. 3. Fügen Sie ihn in Callin ein und speichern Sie. > **Wichtig:** Halten Sie diesen Schlüssel vertraulich. Personen mit Zugriff könnten versuchen, ihn in einer anderen Umgebung zu verwenden. ## Analytics & Tracking API Keys **Wofür es ist:** Diese Integration verbindet Ihr White Label mit **Marketing-Tracking und Analytics**. Laut den im Panel angezeigten Hinweisen werden unterstützt: * **Google Ads**-Tracking über eine Pixel-ID * **Google Analytics (GA4)**-Tracking über eine Measurement-ID **Warum das im White Label wichtig ist:** Wenn Sie Kampagnen schalten (oder saubere Attribution brauchen), möchten Sie Traffic und Conversions messen, um Budget und ROI zu optimieren. ### Was Sie benötigen (wie im Panel angezeigt) * **Google-Ads-Pixel-ID** (Beispielformat: `AW-123456789`) * **Google-Analytics-Measurement-ID (GA4)** (Beispielformat: `G-XXXXXXXXXX`)Screenshot: Tracking-Einrichtung, bei der Sie die IDs für Google Ads und GA4 einfügen und speichern.
### So verbinden Sie das Tracking 1. Öffnen Sie **Analytics & Tracking API Keys**. 2. Kopieren Sie in Google Ads die Pixel-ID und fügen Sie sie in das passende Feld ein. 3. Kopieren Sie in Google Analytics (GA4) die Measurement-ID und fügen Sie sie in das GA4-Feld ein. 4. Speichern Sie. ### Was nach dem Speichern passiert (wie im Panel beschrieben) * Tracking-Skripte können mit den von Ihnen eingegebenen IDs eingebunden werden (für diese Marke). * Wenn ein Feld leer bleibt, sollte das Skript dieses Anbieters für diese Marke nicht geladen werden. * Der Zugriff zum Anzeigen/Ändern dieser IDs ist auf Benutzer mit dem passenden Zugriffslevel beschränkt (wie im Panel angegeben). > **Tipp:** Verbinden Sie Tracking direkt zu Beginn eines Marken-Launches, damit Ihnen keine Attributionsdaten ab Tag 1 fehlen. # Integraciones Source: https://support.callin.io/Automations/Whitelabel/Stripe-copied-2 Conecta servicios externos (pagos, voz/SMS, email, chat en vivo y tracking) para que tu White Label funcione como un producto real. ## Para qué sirve esta página La página de **Integraciones** es donde conectas tu White Label con los servicios que hacen posible la operativa diaria: * **Pagos y suscripciones** (para poder cobrar a clientes) * **Voz y SMS** (para que funcionen las llamadas y mensajes) * **Envío de emails** (para que el cliente reciba correos importantes) * **Chat en vivo** (para soporte en tiempo real dentro de la app) * **Tracking de marketing** (para medir adquisición y conversiones) Ábrela aquí: [Abrir Integraciones](https://app.callin.io/cms/api-keys)Captura: vista general de Integraciones. Cada tarjeta abre un panel de configuración con los campos exactos a completar.
> **Importante:** Las etiquetas de estado (por ejemplo “conectado” o “requerido”) reflejan tu configuración actual y pueden variar según tu cuenta y plan. ## Antes de conectar nada Unas prácticas simples te ahorran problemas (y mejoran la seguridad): * **Usa el usuario administrador correcto** en cada proveedor (Stripe, Twilio, etc.) para acceder a claves y ajustes. * **Guarda las claves de forma segura** (trátalas como contraseñas). * **Limita el acceso** solo a quien lo necesite. No pegues claves en documentos compartidos o chats. > **Consejo:** Si algo no funciona a la primera, revisa que no hayas pegado espacios al principio o al final de una clave. ## Cómo se conecta una integración La mayoría de integraciones siguen el mismo patrón: 1. Abres una tarjeta (por ejemplo Twilio o SendGrid). 2. Se abre un panel lateral con campos obligatorios (marcados con `*`). 3. Copias los valores desde el panel del proveedor. 4. Pegas los valores en Callin y guardas. > **Importante:** El texto exacto de botones y etiquetas puede variar según el idioma de tu cuenta. ## Stripe **Para qué sirve:** Stripe se usa para **procesar pagos**. Es la integración típica cuando quieres operar con suscripciones: aceptar pagos, cobrar a clientes y gestionar suscripciones. **Cuándo la necesitas:** Si vas a crear planes de pago y cobrar a tus clientes (mensual, anual, etc.), Stripe suele ser de las primeras integraciones a configurar. ### Qué te va a pedir (tal como se ve en el panel) * **Secret Key**\* * **Webhook Secret**\* * **Webhook Secret Connect**\* * **Client ID**\*Captura: configuración de Stripe donde se introducen las cuatro claves/valores requeridos y se guarda.
### Cómo conectar Stripe 1. Abre la tarjeta de **Stripe**. 2. En tu panel de Stripe, copia los valores necesarios. 3. Pega cada valor en su campo correspondiente. 4. Guarda los cambios. > **Importante:** Si más adelante rotas claves o cambias webhooks en Stripe, tendrás que volver aquí y actualizar los valores. ## Twilio **Para qué sirve:** Twilio habilita **llamadas de voz y SMS**. Es la integración que hace posibles las funciones de llamadas/mensajería y también el manejo de números de teléfono. **Cuándo la necesitas:** Si tu White Label incluye llamadas entrantes/salientes o SMS, Twilio suele ser esencial y puede aparecer marcado como “requerido”. ### Qué te va a pedir (tal como se ve en el panel) * **Account SID**\* * **Auth Token**\*Captura: configuración de Twilio donde se introduce el Account SID y el Auth Token.
### Cómo conectar Twilio 1. Abre la tarjeta de **Twilio**. 2. En tu panel de Twilio, localiza **Account SID** y **Auth Token**. 3. Pégalos en Callin. 4. Guarda los cambios. > **Consejo:** Si más adelante las llamadas o los SMS fallan, Twilio suele ser la primera integración que conviene revisar. ## SendGrid **Para qué sirve:** SendGrid se usa para **enviar emails** desde tu White Label, especialmente correos automáticos y notificaciones que el cliente necesita recibir (por ejemplo: mensajes del sistema). **Cuándo la necesitas:** Si tu experiencia branded debe enviar correos a clientes, configura SendGrid pronto. ### Qué te va a pedir (tal como se ve en el panel) * **API Key**\* * **Sender Email**\* (un email remitente verificado)Captura: configuración de SendGrid donde se introduce la API Key y el email remitente.
### Cómo conectar SendGrid 1. Abre la tarjeta de **SendGrid**. 2. Copia tu **API Key** desde SendGrid. 3. Introduce un **Sender Email** que esté verificado en SendGrid. 4. Guarda los cambios. > **Error común:** Usar un remitente que no está verificado. Si no se envían emails, verifica primero el remitente en SendGrid. ## Intercom **Para qué sirve:** Intercom habilita **chat en vivo y soporte** dentro de la app. Es una opción habitual cuando quieres que el cliente pueda escribir a tu equipo sin salir del producto. **Cuándo la necesitas:** Si el soporte y el onboarding forman parte de lo que vendes, Intercom hace que tu White Label se sienta más “producto”. ### Qué te va a pedir (tal como se ve en el panel) * **App ID**\* (desde la configuración de tu workspace de Intercom)Captura: configuración de Intercom donde se introduce el App ID.
### Cómo conectar Intercom 1. Abre la tarjeta de **Intercom**. 2. Busca tu **App ID** en la configuración de tu workspace de Intercom. 3. Pégalo en Callin y guarda los cambios. > **Consejo:** Usa el workspace de Intercom que realmente vaya a atender a tus clientes, para que los mensajes lleguen al equipo correcto. ## Brevo Chat **Para qué sirve:** Brevo Chat habilita un **widget de chat** para conversaciones en tiempo real. El panel hace referencia a Brevo (antes Sendinblue) y la activación se realiza con una clave de widget. **Cuándo la necesitas:** Si prefieres un widget de chat más ligero (en lugar de Intercom), Brevo Chat es una opción. ### Qué te va a pedir (tal como se ve en el panel) * **Chat Widget Key**\* (también descrita como Chat Widget Key/API Key)Captura: configuración de Brevo Chat donde se introduce la clave del widget.
### Cómo conectar Brevo Chat 1. Abre la tarjeta de **Brevo Chat**. 2. En tu panel de Brevo, copia la **Chat Widget Key** (o Chat Widget Key/API Key). 3. Pégala en Callin y guarda los cambios. > **Importante:** Mantén esta clave en privado. Cualquiera con acceso podría intentar reutilizarla en otro entorno. ## Analytics & Tracking API Keys **Para qué sirve:** Esta integración conecta tu White Label con **tracking de marketing y analítica**. Según las instrucciones que se ven en el panel, soporta: * **Google Ads** mediante un Pixel ID * **Google Analytics (GA4)** mediante un Measurement ID **Por qué es importante en White Label:** Si vas a hacer campañas (o necesitas atribución), te interesa medir conversiones y tráfico para optimizar inversión y entender qué canal funciona. ### Qué te va a pedir (tal como se ve en el panel) * **Google Ads Pixel ID** (formato de ejemplo: `AW-123456789`) * **Google Analytics Measurement ID (GA4)** (formato de ejemplo: `G-XXXXXXXXXX`)Captura: configuración de tracking donde se pegan los IDs de Google Ads y GA4 y se guardan.
### Cómo conectar el tracking 1. Abre **Analytics & Tracking API Keys**. 2. En Google Ads, copia tu **Google Ads Pixel ID** y pégalo en su campo. 3. En Google Analytics (GA4), copia tu **Measurement ID** y pégalo en el campo de GA4. 4. Guarda los cambios. ### Qué pasa después de guardar (según se indica en el panel) * Se pueden inyectar scripts de tracking usando los IDs que has introducido (para esta marca). * Si dejas un campo vacío, el script de ese proveedor no debería cargarse para esta marca. * El acceso para ver o cambiar estos IDs está limitado a usuarios con el nivel de acceso adecuado (tal como se indica en el panel). > **Consejo:** Conecta el tracking al principio del lanzamiento de una marca, para no perder datos de atribución desde el día 1. # Integrazioni Source: https://support.callin.io/Automations/Whitelabel/Stripe-copied-3 Collega servizi esterni (pagamenti, voce/SMS, email, chat dal vivo e tracciamento) così il tuo White Label funziona come un prodotto completo. ## A cosa serve questa pagina La pagina **Integrazioni** è il punto in cui colleghi il tuo White Label ai servizi che rendono possibile l’operatività quotidiana: * **Pagamenti e abbonamenti** (per addebitare i clienti) * **Voce e SMS** (per abilitare chiamate e messaggi) * **Invio email** (perché i clienti ricevano email importanti) * **Chat dal vivo** (per offrire supporto in tempo reale nell’app) * **Tracciamento marketing** (per misurare acquisizione e conversioni) Aprila qui: [Apri Integrazioni](https://app.callin.io/cms/api-keys)Schermata: panoramica delle integrazioni. Ogni scheda apre un pannello con i campi esatti da compilare.
> **Importante:** I badge di stato visibili sulle schede (ad esempio “connesso” o “richiesto”) riflettono la tua configurazione attuale e possono variare in base al tuo account e al tuo piano. ## Prima di collegare qualsiasi cosa Alcune buone abitudini rendono tutto più semplice (e più sicuro): * Usa l’**account amministratore corretto** per ogni provider (Stripe, Twilio, ecc.) così puoi accedere a chiavi e impostazioni. * **Conserva le chiavi in modo sicuro** (trattale come password). * **Limita l’accesso** a chi ne ha bisogno. Evita di incollare chiavi in documenti condivisi o chat. > **Consiglio:** Se un’integrazione non funziona al primo tentativo, controlla prima di tutto che non ci siano spazi all’inizio o alla fine di una chiave. ## Come si collega un’integrazione La maggior parte delle integrazioni segue lo stesso schema: 1. Clicchi su una scheda (ad esempio Twilio o SendGrid). 2. Si apre un pannello laterale con campi obbligatori (contrassegnati con `*`). 3. Copi i valori dalla dashboard del provider. 4. Li incolli in Callin e salvi. ## Stripe **A cosa serve:** Stripe gestisce l’**elaborazione dei pagamenti**. È l’integrazione tipica per un modello a sottoscrizione: incassare, addebitare i clienti e gestire gli abbonamenti. **Quando ti serve:** Se vuoi creare piani a pagamento e addebitare i clienti (mensile, annuale, ecc.), configura Stripe tra le prime cose. ### Cosa ti serve (come indicato nel pannello) * **Chiave segreta**\* * **Segreto webhook**\* * **Segreto webhook (Connect)**\* * **ID client**\*Schermata: configurazione Stripe con quattro valori richiesti da inserire e salvare.
### Come collegare Stripe 1. Apri la scheda **Stripe**. 2. Nella dashboard di Stripe, copia i valori richiesti. 3. Incolla ogni valore nel campo corrispondente in Callin. 4. Salva. > **Importante:** Se in futuro rigeneri le chiavi o modifichi i webhook in Stripe, dovrai tornare qui e aggiornare questi valori. ## Twilio **A cosa serve:** Twilio abilita **chiamate vocali e SMS**. È l’integrazione che rende possibili le funzioni di chiamata/messaggistica e supporta anche la gestione dei numeri di telefono. **Quando ti serve:** Se il tuo White Label include chiamate in entrata/uscita o SMS, Twilio è di solito essenziale e può comparire come “richiesto”. ### Cosa ti serve (come indicato nel pannello) * **SID dell’account**\* * **Token di autenticazione**\*Schermata: configurazione Twilio con SID dell’account e token di autenticazione da inserire.
### Come collegare Twilio 1. Apri la scheda **Twilio**. 2. Nella dashboard di Twilio, recupera il SID dell’account e il token di autenticazione. 3. Incollali in Callin. 4. Salva. > **Consiglio:** Se in seguito chiamate o SMS non funzionano, Twilio è spesso la prima integrazione da ricontrollare. ## SendGrid **A cosa serve:** SendGrid serve per **inviare email** dal tuo White Label, in particolare email automatiche e notifiche di cui i clienti hanno bisogno (ad esempio messaggi di sistema). **Quando ti serve:** Se la tua esperienza brandizzata deve inviare email ai clienti, configura SendGrid presto. ### Cosa ti serve (come indicato nel pannello) * **Chiave API**\* * **Email mittente**\* (un mittente verificato)Schermata: configurazione SendGrid con chiave API ed email mittente da inserire.
### Come collegare SendGrid 1. Apri la scheda **SendGrid**. 2. Copia la tua chiave API da SendGrid. 3. Inserisci un’email mittente verificata in SendGrid. 4. Salva. > **Errore comune:** Usare un mittente non verificato. Se le email non vengono inviate, verifica prima il mittente in SendGrid. ## Intercom **A cosa serve:** Intercom abilita **chat dal vivo e supporto clienti** direttamente nell’app. È una scelta comune se vuoi che i clienti possano scrivere al tuo team senza uscire dal prodotto. **Quando ti serve:** Se supporto e onboarding sono parte di ciò che vendi, Intercom aiuta il tuo White Label a sembrare più “pronto all’uso”. ### Cosa ti serve (come indicato nel pannello) * **ID app**\* (dalle impostazioni del tuo workspace Intercom)Schermata: configurazione Intercom con l’ID app da inserire.
### Come collegare Intercom 1. Apri la scheda **Intercom**. 2. In Intercom, trova l’ID app nelle impostazioni del tuo workspace. 3. Incollalo in Callin e salva. > **Consiglio:** Usa il workspace Intercom che verrà realmente usato dal team di supporto, così i messaggi arrivano al posto giusto. ## Brevo Chat **A cosa serve:** Brevo Chat abilita un **widget di chat** per conversazioni in tempo reale. Il pannello fa riferimento a Brevo (ex Sendinblue) e l’attivazione avviene tramite una chiave del widget. **Quando ti serve:** Se preferisci un widget di chat più leggero (rispetto a Intercom), Brevo Chat è un’opzione. ### Cosa ti serve (come indicato nel pannello) * **Chiave widget chat**\* (descritta anche come chiave widget/chiave API)Schermata: configurazione Brevo Chat con la chiave del widget da inserire.
### Come collegare Brevo Chat 1. Apri la scheda **Brevo Chat**. 2. Nella dashboard di Brevo, copia la chiave del widget chat. 3. Incollala in Callin e salva. > **Importante:** Mantieni questa chiave privata. Chiunque vi abbia accesso potrebbe tentare di riutilizzarla in un altro ambiente. ## Analytics & Tracking API Keys **A cosa serve:** Questa integrazione collega il tuo White Label al **tracciamento marketing e all’analisi**. In base alle istruzioni mostrate nel pannello, supporta: * Tracciamento **Google Ads** tramite ID pixel * Tracciamento **Google Analytics (GA4)** tramite ID di misurazione **Perché è importante nel White Label:** Se fai campagne (o ti serve attribuzione), vuoi misurare traffico e conversioni per ottimizzare budget e capire quali canali funzionano. ### Cosa ti serve (come indicato nel pannello) * **ID pixel Google Ads** (formato esempio: `AW-123456789`) * **ID di misurazione Google Analytics (GA4)** (formato esempio: `G-XXXXXXXXXX`)Schermata: configurazione del tracking dove incolli gli ID di Google Ads e GA4 e poi salvi.
### Come collegare il tracking 1. Apri **Analytics & Tracking API Keys**. 2. In Google Ads, copia l’ID pixel e incollalo nel campo corrispondente. 3. In Google Analytics (GA4), copia l’ID di misurazione e incollalo nel campo GA4. 4. Salva. ### Cosa succede dopo il salvataggio (come descritto nel pannello) * Gli script di tracking possono essere inseriti usando gli ID che hai inserito (per questo brand). * Se un campo è vuoto, lo script del relativo provider non dovrebbe essere caricato per questo brand. * L’accesso per visualizzare o modificare questi ID è limitato agli utenti con il livello di accesso adeguato (come indicato nel pannello). > **Consiglio:** Collega il tracking all’inizio del lancio di un brand per non perdere dati di attribuzione fin dal giorno 1. # Intégrations Source: https://support.callin.io/Automations/Whitelabel/Stripe-copied-4 Connectez des services externes (paiements, voix/SMS, email, chat en direct et suivi) pour que votre White Label fonctionne comme un produit complet. ## À quoi sert cette page La page **Intégrations** est l’endroit où vous connectez votre White Label aux services qui rendent l’exploitation quotidienne possible : * **Paiements et abonnements** (pour facturer vos clients) * **Voix et SMS** (pour activer les appels et la messagerie) * **Envoi d’emails** (pour que vos clients reçoivent les emails importants) * **Chat en direct** (pour offrir du support en temps réel dans l’app) * **Suivi marketing** (pour mesurer l’acquisition et les conversions) Pour ouvrir cette page, cliquez ici : [Ouvrir les intégrations](https://app.callin.io/cms/api-keys)Capture : vue d’ensemble des intégrations. Chaque carte ouvre un panneau avec les champs exacts à compléter.
> **Important :** Les badges d’état visibles sur les cartes (par exemple « connecté » ou « requis ») reflètent votre configuration actuelle et peuvent varier selon votre compte et votre offre. ## Avant de connecter quoi que ce soit Quelques bonnes pratiques rendent la configuration plus simple (et plus sûre) : * Utilisez le **bon compte administrateur** chez chaque fournisseur (Stripe, Twilio, etc.) pour accéder aux clés et paramètres. * **Stockez les clés en sécurité** (traitez-les comme des mots de passe). * **Limitez l’accès** aux personnes qui en ont besoin. Évitez de coller des clés dans des documents partagés ou des chats. > **Conseil :** Si une intégration ne fonctionne pas du premier coup, vérifiez d’abord qu’il n’y a pas d’espace au début ou à la fin d’une clé. ## Comment se connecte une intégration La plupart des intégrations suivent le même schéma : 1. Cliquez sur une carte (par exemple Twilio ou SendGrid). 2. Un panneau latéral s’ouvre avec des champs obligatoires (marqués par `*`). 3. Copiez les valeurs depuis le tableau de bord du fournisseur. 4. Collez-les dans Callin et enregistrez. ## Stripe **À quoi ça sert :** Stripe sert au **traitement des paiements**. C’est l’intégration la plus courante pour gérer une activité par abonnement : encaisser, facturer vos clients et gérer les abonnements. **Quand vous en avez besoin :** Si vous comptez créer des offres payantes et facturer vos clients (mensuel, annuel, etc.), configurez Stripe en tout premier. ### Ce dont vous aurez besoin (comme indiqué dans le panneau) * **Clé secrète**\* * **Secret de webhook**\* * **Secret de webhook (Connect)**\* * **ID client**\*Capture : configuration Stripe avec quatre valeurs requises à saisir puis à enregistrer.
### Comment connecter Stripe 1. Ouvrez la carte **Stripe**. 2. Dans votre tableau de bord Stripe, copiez les valeurs demandées. 3. Collez chaque valeur dans le champ correspondant dans Callin. 4. Enregistrez. > **Important :** Si vous régénérez des clés ou modifiez des webhooks dans Stripe plus tard, vous devrez revenir ici et mettre à jour ces valeurs. ## Twilio **À quoi ça sert :** Twilio active les **appels vocaux et les SMS**. C’est l’intégration qui rend possibles les fonctionnalités d’appels/messagerie et qui prend en charge la gestion des numéros. **Quand vous en avez besoin :** Si votre White Label inclut des appels entrants/sortants ou des SMS, Twilio est généralement indispensable et peut apparaître comme « requis ». ### Ce dont vous aurez besoin (comme indiqué dans le panneau) * **Identifiant du compte (SID)**\* * **Jeton d’authentification**\*Capture : configuration Twilio avec l’identifiant du compte et le jeton d’authentification à renseigner.
### Comment connecter Twilio 1. Ouvrez la carte **Twilio**. 2. Dans votre tableau de bord Twilio, récupérez l’identifiant du compte (SID) et le jeton d’authentification. 3. Collez-les dans Callin. 4. Enregistrez. > **Conseil :** Si les appels ou les SMS ne fonctionnent plus ensuite, Twilio est souvent la première intégration à vérifier. ## SendGrid **À quoi ça sert :** SendGrid sert à **envoyer des emails** depuis votre White Label, notamment des emails automatiques et des notifications dont vos clients ont besoin (par exemple des messages système). **Quand vous en avez besoin :** Si votre expérience sous marque doit envoyer des emails aux clients, configurez SendGrid tôt. ### Ce dont vous aurez besoin (comme indiqué dans le panneau) * **Clé API**\* * **Email expéditeur**\* (un expéditeur vérifié)Capture : configuration SendGrid avec une clé API et un email expéditeur à saisir.
### Comment connecter SendGrid 1. Ouvrez la carte **SendGrid**. 2. Copiez votre clé API depuis SendGrid. 3. Renseignez un email expéditeur qui est vérifié dans SendGrid. 4. Enregistrez. > **Erreur fréquente :** Utiliser un expéditeur non vérifié. Si les emails ne partent pas, vérifiez d’abord l’expéditeur dans SendGrid. ## Intercom **À quoi ça sert :** Intercom active le **chat en direct et le support client** dans l’app. C’est un choix fréquent si vous voulez que les clients contactent votre équipe sans quitter le produit. **Quand vous en avez besoin :** Si le support et l’onboarding font partie de ce que vous vendez, Intercom aide votre White Label à paraître plus « prêt à l’emploi ». ### Ce dont vous aurez besoin (comme indiqué dans le panneau) * **ID d’application**\* (depuis les paramètres de votre espace Intercom)Capture : configuration Intercom avec l’ID d’application à renseigner.
### Comment connecter Intercom 1. Ouvrez la carte **Intercom**. 2. Dans Intercom, trouvez l’ID d’application dans les paramètres de votre espace. 3. Collez-le dans Callin et enregistrez. > **Conseil :** Choisissez l’espace Intercom qui correspond à votre équipe support, pour que les messages arrivent au bon endroit. ## Brevo Chat **À quoi ça sert :** Brevo Chat active un **widget de chat** pour des conversations en temps réel. Le panneau fait référence à Brevo (anciennement Sendinblue) et l’activation se fait via une clé de widget. **Quand vous en avez besoin :** Si vous préférez un widget de chat plus léger (plutôt qu’Intercom), Brevo Chat est une option. ### Ce dont vous aurez besoin (comme indiqué dans le panneau) * **Clé de widget de chat**\* (également décrite comme clé de widget/clé API)Capture : configuration Brevo Chat avec la clé du widget à saisir.
### Comment connecter Brevo Chat 1. Ouvrez la carte **Brevo Chat**. 2. Dans Brevo, copiez la clé du widget de chat. 3. Collez-la dans Callin et enregistrez. > **Important :** Gardez cette clé confidentielle. Toute personne qui y a accès pourrait tenter de la réutiliser dans un autre environnement. ## Analytics & Tracking API Keys **À quoi ça sert :** Cette intégration connecte votre White Label au **suivi marketing et à l’analytique**. D’après les instructions affichées dans le panneau, elle prend en charge : * Le suivi **Google Ads** via un identifiant de pixel * Le suivi **Google Analytics (GA4)** via un identifiant de mesure **Pourquoi c’est important en White Label :** Si vous lancez des campagnes (ou si vous avez besoin d’attribution), vous voulez mesurer trafic et conversions pour optimiser votre budget et comprendre quels canaux fonctionnent. ### Ce dont vous aurez besoin (comme indiqué dans le panneau) * **Identifiant de pixel Google Ads** (format exemple : `AW-123456789`) * **Identifiant de mesure Google Analytics (GA4)** (format exemple : `G-XXXXXXXXXX`)Capture : configuration du tracking où vous collez les identifiants Google Ads et GA4 puis enregistrez.
### Comment connecter le tracking 1. Ouvrez **Analytics & Tracking API Keys**. 2. Dans Google Ads, copiez l’identifiant de pixel et collez-le dans le champ correspondant. 3. Dans Google Analytics (GA4), copiez l’identifiant de mesure et collez-le dans le champ GA4. 4. Enregistrez. ### Ce qui se passe après l’enregistrement (tel que décrit dans le panneau) * Des scripts de suivi peuvent être injectés à partir des identifiants que vous avez saisis (pour cette marque). * Si un champ est laissé vide, le script du fournisseur correspondant ne devrait pas se charger pour cette marque. * L’accès pour voir ou modifier ces identifiants est limité aux utilisateurs ayant le niveau d’accès requis (comme indiqué dans le panneau). > **Conseil :** Connectez le tracking dès le lancement d’une marque pour éviter de perdre des données d’attribution dès le jour 1. # Subscriptions Source: https://support.callin.io/Automations/Whitelabel/Subscriptions Review which subscription each customer has, including plan, price, minutes, status, and dates. ## What this page is for The **Subscriptions** page gives you a **read-only overview** of the subscriptions your customers have. It’s designed for reviewing—not for editing—so you can quickly answer questions like: * “Which plan is this customer on?” * “Is their subscription active, past due, or canceled?” * “How many minutes are included and how many have been used?” * “When did the subscription start and when does it end?” > **Tip:** The exact labels and available options can vary depending on your account, plan, and language settings. ## How to use the list ### Search subscriptions At the top, use the **Search subscriptions…** field to find a customer quickly (for example, by email or name). ### Understand the columns In the table you’ll typically see: * **User**: the customer’s identifier (often email, sometimes name) * **Plan**: the plan name (for example, a monthly plan or pay-as-you-go) * **Price**: the cost of the plan (if shown for that plan) * **Minutes**: included minutes and usage (for example, “Used”) * **Status**: the current state of the subscription * **Start Date** and **End Date**: the subscription period ## Subscription status examples The list may show statuses like: * **Active**: the subscription is currently running * **Past Due**: payment is overdue * **Canceled**: the subscription was canceled > **Important:** If a customer says “I paid” but their status is not **Active**, the most common checks are: the correct user/email and the current subscription status on this page. # Suscripciones Source: https://support.callin.io/Automations/Whitelabel/Subscriptions-copied-1 Revisa qué suscripción tiene cada cliente, incluyendo plan, precio, minutos, estado y fechas. ## Para qué sirve esta página La página de **Suscripciones** te da una **vista de solo lectura** de las suscripciones que tienen tus clientes. Está pensada para revisar (no para editar), y así responder rápido a preguntas como: * “¿Qué plan tiene este cliente?” * “¿La suscripción está activa, con pago pendiente o cancelada?” * “¿Cuántos minutos incluye y cuántos se han usado?” * “¿Cuándo empezó y cuándo termina la suscripción?” > **Consejo:** Las etiquetas exactas y las opciones disponibles pueden variar según tu cuenta, tu plan y el idioma configurado. ## Cómo usar la lista ### Buscar suscripciones Arriba tienes el campo **Search subscriptions…** para encontrar un cliente rápido (por ejemplo, por email o nombre). ### Entender las columnas En la tabla normalmente verás: * **User**: el identificador del cliente (muchas veces el email, a veces el nombre) * **Plan**: el nombre del plan (por ejemplo, mensual o pago por uso) * **Price**: el precio del plan (si aplica y se muestra para ese plan) * **Minutes**: minutos incluidos y uso (por ejemplo, “Used”) * **Status**: estado actual de la suscripción * **Start Date** y **End Date**: el periodo de la suscripción ## Ejemplos de estados de suscripción En la lista pueden aparecer estados como: * **Active**: la suscripción está en curso * **Past Due**: hay un pago pendiente * **Canceled**: la suscripción se canceló > **Importante:** Si un cliente dice “he pagado” pero el estado no es **Active**, lo más habitual es comprobar: que sea el usuario/email correcto y el estado actual de su suscripción en esta página. # Abonnements Source: https://support.callin.io/Automations/Whitelabel/Subscriptions-copied-3 Prüfen Sie, welches Abonnement jeder Kunde hat – inklusive Plan, Preis, Minuten, Status und Daten. ## Wofür diese Seite da ist Die Seite **Abonnements** zeigt Ihnen eine **Nur-Lese-Übersicht** über die Abonnements Ihrer Kunden. Sie ist zum Prüfen gedacht (nicht zum Bearbeiten), damit Sie schnell Fragen beantworten können wie: * „Welchen Plan hat dieser Kunde?“ * „Ist das Abonnement aktiv, überfällig oder gekündigt?“ * „Wie viele Minuten sind enthalten und wie viele wurden genutzt?“ * „Wann hat das Abonnement begonnen und wann endet es?“ > **Tipp:** Exakte Bezeichnungen und verfügbare Optionen können je nach Konto, Plan und Spracheinstellung variieren. ## So nutzen Sie die Liste ### Abonnements suchen Oben können Sie über das Feld **Search subscriptions…** einen Kunden schnell finden (zum Beispiel per E-Mail oder Name). ### Spalten verstehen In der Tabelle sehen Sie typischerweise: * **User**: die Kennung des Kunden (oft die E-Mail, manchmal der Name) * **Plan**: der Planname (zum Beispiel monatlich oder pay-as-you-go) * **Price**: der Preis des Plans (falls für diesen Plan angezeigt) * **Minutes**: enthaltene Minuten und Nutzung (zum Beispiel „Used“) * **Status**: der aktuelle Abostatus * **Start Date** und **End Date**: der Abrechnungszeitraum ## Beispiele für Abostatus In der Liste können Status wie diese erscheinen: * **Active**: das Abonnement läuft aktuell * **Past Due**: eine Zahlung ist überfällig * **Canceled**: das Abonnement wurde gekündigt > **Wichtig:** Wenn ein Kunde sagt „ich habe bezahlt“, der Status aber nicht **Active** ist, sind die häufigsten Checks: die richtige Nutzer/E-Mail und der aktuelle Abostatus auf dieser Seite. # Abbonamenti Source: https://support.callin.io/Automations/Whitelabel/Subscriptions-copied-7 Controlla quale abbonamento ha ogni cliente, inclusi piano, prezzo, minuti, stato e date. ## A cosa serve questa pagina La pagina **Abbonamenti** ti mostra una **vista in sola lettura** degli abbonamenti dei tuoi clienti. È pensata per consultare (non per modificare), così puoi rispondere rapidamente a domande come: * “Che piano ha questo cliente?” * “L’abbonamento è attivo, in ritardo di pagamento o annullato?” * “Quanti minuti sono inclusi e quanti ne sono stati usati?” * “Quando è iniziato e quando termina l’abbonamento?” > **Consiglio:** Le etichette esatte e le opzioni disponibili possono variare in base al tuo account, al tuo piano e alla lingua impostata. ## Come usare la lista ### Cercare gli abbonamenti In alto, usa il **campo di ricerca** per trovare rapidamente un cliente (ad esempio tramite email o nome). ### Capire le colonne Nella tabella vedrai di solito: * **Utente**: l’identificativo del cliente (spesso l’email, a volte il nome) * **Piano**: il nome del piano associato * **Prezzo**: il prezzo del piano (se applicabile e mostrato per quel piano) * **Minuti**: minuti inclusi e utilizzo (ad esempio minuti usati) * **Stato**: lo stato attuale dell’abbonamento * **Data di inizio** e **Data di fine**: il periodo dell’abbonamento ## Esempi di stati dell’abbonamento Nella lista possono comparire stati come: * **Attivo**: l’abbonamento è attivo * **Pagamento in ritardo**: un pagamento è in ritardo * **Annullato**: l’abbonamento è stato annullato > **Importante:** Se un cliente dice “ho pagato” ma lo stato non risulta **Attivo**, i controlli più comuni sono: verificare di essere sul cliente/email corretti e controllare lo stato attuale dell’abbonamento in questa pagina. # Subscription Plans Source: https://support.callin.io/Automations/Whitelabel/SubscriptionsPlans Create and manage the subscription plans your white-label sub-accounts can sell to their own users. ## What this section is for **Subscription Plans** is where a white-label account defines the plans that will be available to its **sub-accounts** (your customers). Those sub-accounts can then offer these plans to their own end users—for example, to sell monthly minutes, enable paid add-ons, or control which features are included per tier. After you set up plans here, you typically use them to: * Create clear tiers (Starter, Pro, Enterprise) with different minutes and pricing. * Decide whether customers can buy extra minutes after they consume their included minutes. * Mark one plan as **Popular** so it stands out on your pricing page (if shown in your setup). [Click here to open Subscription Plans](https://app.callin.io/cms/subscription-plans)Screenshot: the Subscription Plans list, where you can search plans, create a new one, and manage existing plans from the actions menu.
## Create a new subscription plan From **Plans & Billing → Subscription Plans**, click **Create Plan**. A guided flow will walk you through the setup step by step. > **Tip:** Before creating plans, decide your tiers and pricing on paper first (e.g., “Starter: 400 minutes/month for \$300”). It makes the setup faster and avoids later changes.Screenshot: Step 1 of the plan creation wizard, where you name the plan, add a description, and choose whether it’s Active and/or Popular.
### Step 1: Basic information Fill in the essentials: * **Plan Name**: Required. This is what your customers will recognize (e.g., **Starter**, **Growth**, **Pro**). * **Description**: Optional but strongly recommended. Explain what’s included in plain language. * **Active**: When enabled, the plan is available to users. * **Popular**: When enabled, this plan can be highlighted as a recommended option. **Practical example** * Plan Name: **Starter** * Description: “Includes 400 minutes per month. Great for small teams who want reliable call coverage and a predictable monthly price.” * Active: **On** * Popular: **On** (only for the plan you want most people to choose) > **Common mistake:** Leaving the description empty. A short description reduces confusion and support tickets (“What’s included in this plan?”). ### Step 2: Choose a plan type Select how you want to bill: * **Monthly Subscription**: Recurring monthly billing with a set number of minutes and a fixed monthly price. * **One-Time Purchase**: A single payment for a fixed amount of minutes. * **Pay as You Go**: Pay per minute with flexible usage. > **Important:** The available plan types may vary depending on your account setup. ### Step 3: Pricing & minutes The next screen depends on the plan type. For a **Monthly Subscription**, you typically configure: * **Available Minutes per Month**: How many minutes are included every month (e.g., **400**). * **Price**: The monthly price users pay (e.g., **\$300/month**). Optional controls you may see: * **Additional Minutes**: Allow customers to purchase extra minutes beyond the included monthly minutes. * If enabled, set the **Rate per Additional Minute** (e.g., **\$0.30/min**). * **Annual Billing**: Offer yearly billing with a discount (when available in your setup). **Practical example (monthly plan)** * Included minutes: **400 minutes/month** * Monthly price: **\$300/month** * Additional minutes: **Enabled** * Additional minute rate: **\$0.30/min** This means: * A customer pays \$300 each month and gets 400 minutes. * If they use 430 minutes, the extra 30 minutes are billed at $0.30/min (30 × 0.30 = $9). ### Step 4: Configure features On the **Features** step, you assign values to the features that exist in your platform setup (often defined under **Features & Capabilities**). Depending on the feature, you might set: * A toggle (on/off) * A numeric limit * A text value **Practical example** * Feature: “Starter minutes” * Value: **400** If you don’t see many features here, it usually means only a few features have been defined for your workspace. ### Step 5: Review & create Before creating the plan, you’ll see a summary of what you configured: * Basic information (name, description, status) * Plan type * Pricing & minutes * Features Use **Edit** on any section if something looks off, then click **Create** to finish. > **Tip:** Double-check the minutes and price together. Most pricing mistakes are just a mismatch (e.g., “400 minutes” but priced like the “1000 minutes” tier). ## Edit an existing plan To edit a plan, go to the plans list, open the **three-dot** menu, and choose **Edit Plan**. Inside the editor you typically see tabs such as: * **Basic Info**: Update name, description, and toggles like Active/Popular. * **Features**: Adjust feature values for this plan. * **Pricing & Minutes**: Update included minutes, price, and additional-minute settings.Screenshot: editing a plan’s pricing and minutes, including the notice that price changes create a new Stripe price and won’t affect existing subscribers.
> **Important:** When you change a plan’s price, the platform may create a **new price in Stripe**. Existing subscribers can continue on their current price and may not be affected by the change (behavior can vary depending on your billing setup). ## Manage plan lifecycle (Copy ID, deactivate, and search) From the plan list actions menu, you can typically: * **Copy Plan ID**: Useful for support, troubleshooting, or matching the plan inside other areas of the platform. * **Deactivate Plan**: Stops offering the plan to new users. * **Search**: Use the search bar to quickly find a plan by name. > **Common mistake:** Deactivating a plan without first creating a replacement. If you need to retire a plan, create the new plan first, then deactivate the old one so new customers don’t get stuck without options. # Planes de suscripción Source: https://support.callin.io/Automations/Whitelabel/SubscriptionsPlans-copied-1 Crea y gestiona los planes de suscripción que tus cuentas de marca blanca pueden ofrecer a sus subcuentas. ## Para qué sirve esta sección **Planes de suscripción** es el lugar donde una cuenta de marca blanca define los planes que estarán disponibles para sus **subcuentas** (tus clientes). A partir de ahí, esas subcuentas pueden ofrecer estos planes a sus propios usuarios finales: por ejemplo, para vender minutos mensuales, permitir compras de minutos extra o diferenciar niveles (Básico, Pro, etc.). En la práctica, esta sección te ayuda a: * Crear niveles claros con **minutos incluidos** y **precio**. * Controlar si se permiten **minutos adicionales** una vez se consumen los incluidos. * Destacar un plan como “recomendado” (si esa opción está disponible en tu cuenta). [Haz clic aquí para ir a Planes de suscripción](https://app.callin.io/cms/subscription-plans)Captura: listado de planes, con búsqueda, creación de planes y un menú de acciones para gestionar cada plan.
## Crear un nuevo plan de suscripción Desde **Planes y facturación → Planes de suscripción**, pulsa el botón para **crear un plan**. Se abrirá un asistente guiado con varios pasos. > **Consejo:** Antes de crear planes, define tus niveles y precios en un borrador (por ejemplo, “Básico: 400 minutos/mes por 300”). Así evitas cambios de última hora.Captura: primer paso del asistente, donde nombras el plan, describes qué incluye y defines su disponibilidad.
### Paso 1: Información básica Completa lo esencial: * **Nombre del plan**: Obligatorio. Es lo que verán tus clientes (por ejemplo, **Básico**, **Pro**, **Empresa**). * **Descripción**: Recomendado. Explica en una frase qué incluye el plan. * **Activo**: Si está activado, el plan se podrá ofrecer a nuevos usuarios. * **Recomendado**: Si está activado, el plan puede destacarse visualmente (según tu configuración). **Ejemplo práctico** * Nombre del plan: **Básico** * Descripción: “Incluye 400 minutos al mes. Ideal para equipos pequeños que quieren cobertura de llamadas con un precio fijo.” * Activo: **Activado** * Recomendado: **Activado** (solo para el plan que quieres destacar) > **Error común:** Dejar la descripción vacía. Una descripción clara reduce dudas y mensajes de soporte. ### Paso 2: Tipo de plan Elige el modelo de cobro. Normalmente verás opciones como: * **Suscripción mensual**: Cobro recurrente cada mes con minutos y precio fijos. * **Compra única**: Un pago único por una cantidad fija de minutos. * **Pago por uso**: Cobro por minuto con uso flexible. > **Importante:** Las opciones disponibles pueden variar según tu cuenta o plan. ### Paso 3: Precio y minutos La configuración depende del tipo de plan. En una **suscripción mensual**, lo habitual es: * **Minutos disponibles al mes**: Minutos incluidos cada mes (por ejemplo, **400**). * **Precio**: Importe mensual (por ejemplo, **300**). Opciones que pueden aparecer: * **Minutos adicionales**: Permite comprar minutos extra al superar los incluidos. * Si lo activas, define el **precio por minuto adicional** (por ejemplo, **0,30** por minuto). * **Facturación anual**: Ofrece cobro anual con descuento (si está disponible). **Ejemplo práctico (suscripción mensual)** * Minutos incluidos: **400 minutos/mes** * Precio mensual: **300/mes** * Minutos adicionales: **Activado** * Precio por minuto adicional: **0,30/min** Esto significa: * El cliente paga 300 al mes y recibe 400 minutos. * Si consume 430 minutos, los 30 extra se cobran a 0,30/min (30 × 0,30 = 9). ### Paso 4: Configurar funcionalidades En el paso de **funcionalidades**, asignas valores a las funcionalidades que existan en tu plataforma (normalmente definidas en “Funciones y capacidades”). Según la funcionalidad, puedes configurar: * Un interruptor (sí/no) * Un límite numérico * Un valor de texto **Ejemplo práctico** * Funcionalidad: “Minutos del plan” * Valor: **400** Si aquí ves pocas funcionalidades, suele significar que en tu espacio solo se han definido algunas. ### Paso 5: Revisar y crear Antes de terminar, verás un resumen con: * Información básica (nombre, descripción, estado) * Tipo de plan * Precio y minutos * Funcionalidades Si algo no cuadra, usa la opción de **editar** en esa sección y vuelve a revisar. Cuando esté correcto, crea el plan. > **Consejo:** Revisa siempre “minutos incluidos” y “precio” juntos. Los errores más comunes son desajustes entre niveles. ## Editar un plan existente En el listado de planes, abre el **menú de tres puntos** del plan que quieras modificar y elige la opción para **editar**. Dentro del editor, normalmente verás pestañas como: * **Información básica**: Cambiar nombre, descripción y opciones como activo o recomendado. * **Funcionalidades**: Ajustar los valores incluidos en el plan. * **Precio y minutos**: Modificar minutos incluidos, precio y minutos adicionales.Captura: edición de precio y minutos, incluyendo la opción de minutos adicionales y un aviso relacionado con la creación de un nuevo precio en Stripe.
> **Importante:** Al cambiar el precio, la plataforma puede crear un **nuevo precio en Stripe**. Los suscriptores existentes pueden seguir con su precio actual y no verse afectados (puede variar según tu configuración). ## Gestión básica (buscar, copiar ID y desactivar) Desde el listado, normalmente puedes: * **Buscar** un plan por nombre usando la barra de búsqueda. * **Copiar el ID del plan** para soporte o verificaciones internas. * **Desactivar** un plan para que no se ofrezca a nuevos usuarios. > **Error común:** Desactivar un plan sin crear antes uno de reemplazo. Si vas a retirarlo, crea primero el plan nuevo y luego desactiva el anterior. # Piani di abbonamento Source: https://support.callin.io/Automations/Whitelabel/SubscriptionsPlans-copied-2 Crea e gestisci i piani di abbonamento che i tuoi account in white label possono offrire ai loro sotto-account. ## A cosa serve questa sezione I **Piani di abbonamento** permettono a un account in white label di definire i piani che saranno disponibili per i **sotto-account** (i tuoi clienti). Da lì, i sotto-account possono offrire questi piani ai propri utenti finali: ad esempio vendere minuti mensili, consentire l’acquisto di minuti extra o differenziare i livelli (Base, Pro, ecc.). In pratica, questa sezione ti aiuta a: * Creare livelli chiari con **minuti inclusi** e **prezzo**. * Decidere se consentire **minuti aggiuntivi** una volta consumati quelli inclusi. * Mettere in evidenza un piano come “consigliato” (se l’opzione è disponibile nel tuo account). [Fai clic qui per aprire i Piani di abbonamento](https://app.callin.io/cms/subscription-plans)Schermata: elenco dei piani con ricerca, creazione e menu azioni per gestire ogni piano.
## Creare un nuovo piano di abbonamento Da **Piani e fatturazione → Piani di abbonamento**, premi il pulsante per **creare un piano**. Si aprirà una procedura guidata con più passaggi. > **Consiglio:** Prima di creare i piani, definisci livelli e prezzi su un promemoria (ad esempio: “Base: 400 minuti/mese a 300”). Ti evita correzioni dell’ultimo minuto.Schermata: primo passaggio della procedura, dove inserisci nome e descrizione e definisci la disponibilità del piano.
### Passaggio 1: Informazioni di base Compila l’essenziale: * **Nome del piano**: Obbligatorio. È ciò che vedranno i tuoi clienti (ad esempio: **Base**, **Pro**, **Aziendale**). * **Descrizione**: Consigliata. Spiega in una frase cosa include il piano. * **Attivo**: Se attivo, il piano sarà disponibile per i nuovi utenti. * **In evidenza**: Se attivo, il piano può essere messo in risalto (in base alla tua configurazione). **Esempio pratico** * Nome del piano: **Base** * Descrizione: “Include 400 minuti al mese. Ideale per piccoli team che vogliono copertura chiamate con un prezzo fisso.” * Attivo: **Attivato** * In evidenza: **Attivato** (solo per il piano che vuoi mettere in risalto) > **Errore comune:** Lasciare la descrizione vuota. Una descrizione chiara riduce dubbi e richieste al supporto. ### Passaggio 2: Tipo di piano Scegli il modello di addebito. Di solito troverai opzioni come: * **Abbonamento mensile**: Addebito ricorrente mensile con minuti e prezzo fissi. * **Acquisto singolo**: Un pagamento unico per una quantità fissa di minuti. * **Pagamento a consumo**: Addebito al minuto con utilizzo flessibile. > **Importante:** Le opzioni disponibili possono variare in base al tuo account o al tuo piano. ### Passaggio 3: Prezzo e minuti La configurazione dipende dal tipo di piano. Per un **abbonamento mensile**, in genere: * **Minuti disponibili al mese**: Minuti inclusi ogni mese (ad esempio: **400**). * **Prezzo**: Importo mensile (ad esempio: **300**). Opzioni che possono comparire: * **Minuti aggiuntivi**: Consente di acquistare minuti extra oltre quelli inclusi. * Se attivi questa opzione, imposta il **prezzo per minuto aggiuntivo** (ad esempio: **0,30** al minuto). * **Fatturazione annuale**: Offre fatturazione annuale con sconto (se disponibile). **Esempio pratico (abbonamento mensile)** * Minuti inclusi: **400 minuti/mese** * Prezzo mensile: **300/mese** * Minuti aggiuntivi: **Attivato** * Prezzo per minuto aggiuntivo: **0,30/min** Questo significa: * Il cliente paga 300 al mese e riceve 400 minuti. * Se consuma 430 minuti, i 30 extra si pagano a 0,30/min (30 × 0,30 = 9). ### Passaggio 4: Configurare le funzionalità Nel passaggio delle **funzionalità**, assegni valori alle funzionalità disponibili nella tua piattaforma (di solito definite in “Funzioni e capacità”). In base alla funzionalità, potresti configurare: * Un interruttore (sì/no) * Un limite numerico * Un valore testuale **Esempio pratico** * Funzionalità: “Minuti del piano” * Valore: **400** Se qui vedi poche funzionalità, in genere significa che nel tuo spazio ne sono state definite solo alcune. ### Passaggio 5: Verificare e creare Prima di concludere, vedrai un riepilogo con: * Informazioni di base (nome, descrizione, stato) * Tipo di piano * Prezzo e minuti * Funzionalità Se qualcosa non torna, usa l’opzione **modifica** nella sezione interessata e ricontrolla. Quando è tutto corretto, crea il piano. > **Consiglio:** Controlla sempre insieme “minuti inclusi” e “prezzo”. Gli errori più comuni sono disallineamenti tra i livelli. ## Modificare un piano esistente Nell’elenco dei piani, apri il **menu a tre puntini** del piano che vuoi modificare e scegli l’opzione per **modificare**. Nell’editor, di solito trovi schede come: * **Informazioni di base**: Cambiare nome, descrizione e opzioni come attivo o in evidenza. * **Funzionalità**: Regolare i valori inclusi nel piano. * **Prezzo e minuti**: Modificare minuti inclusi, prezzo e minuti aggiuntivi.Schermata: modifica di prezzo e minuti, inclusi minuti aggiuntivi e un avviso relativo alla creazione di un nuovo prezzo in Stripe.
> **Importante:** Cambiando il prezzo, la piattaforma può creare un **nuovo prezzo in Stripe**. Gli abbonati esistenti possono mantenere il prezzo attuale e non essere influenzati (può variare in base alla configurazione). ## Gestione di base (ricerca, copia ID, disattivazione) Dall’elenco, in genere puoi: * **Cercare** un piano per nome tramite la barra di ricerca. * **Copiare l’ID del piano** per supporto o verifiche interne. * **Disattivare** un piano per non offrirlo ai nuovi utenti. > **Errore comune:** Disattivare un piano senza crearne prima uno sostitutivo. Se devi ritirarlo, crea prima il nuovo piano e poi disattiva quello precedente. # Forfaits d’abonnement Source: https://support.callin.io/Automations/Whitelabel/SubscriptionsPlans-copied-3 Créez et gérez les forfaits d’abonnement que vos comptes en marque blanche peuvent proposer à leurs sous-comptes. ## À quoi sert cette section Les **Forfaits d’abonnement** permettent à un compte en marque blanche de définir les forfaits qui seront disponibles pour ses **sous-comptes** (vos clients). Ensuite, ces sous-comptes peuvent proposer ces forfaits à leurs propres utilisateurs finaux : par exemple, vendre des minutes mensuelles, autoriser l’achat de minutes supplémentaires ou distinguer des niveaux (Basique, Pro, etc.). Concrètement, cette section vous aide à : * Créer des niveaux clairs avec des **minutes incluses** et un **prix**. * Contrôler si des **minutes supplémentaires** sont possibles une fois les minutes incluses consommées. * Mettre en avant un forfait comme “recommandé” (si cette option est disponible sur votre compte). [Cliquez ici pour accéder aux Forfaits d’abonnement](https://app.callin.io/cms/subscription-plans)Capture : liste des forfaits, avec recherche, création de forfaits et un menu d’actions pour gérer chaque forfait.
## Créer un nouveau forfait d’abonnement Depuis **Facturation et abonnements → Forfaits d’abonnement**, cliquez sur le bouton pour **créer un forfait**. Un assistant guidé s’ouvre avec plusieurs étapes. > **Astuce :** Avant de créer vos forfaits, définissez vos niveaux et vos prix sur un brouillon (par exemple : “Basique : 400 minutes/mois pour 300”). Cela évite les ajustements de dernière minute.Capture : première étape de l’assistant, où vous nommez le forfait, décrivez ce qu’il inclut et définissez sa disponibilité.
### Étape 1 : Informations de base Renseignez l’essentiel : * **Nom du forfait** : Obligatoire. C’est ce que verront vos clients (par exemple : **Basique**, **Pro**, **Entreprise**). * **Description** : Recommandée. Expliquez en une phrase ce que le forfait inclut. * **Actif** : Si activé, le forfait pourra être proposé aux nouveaux utilisateurs. * **Mis en avant** : Si activé, le forfait peut être mis en évidence (selon votre configuration). **Exemple pratique** * Nom du forfait : **Basique** * Description : “Inclut 400 minutes par mois. Idéal pour les petites équipes qui veulent une couverture d’appels avec un prix fixe.” * Actif : **Activé** * Mis en avant : **Activé** (uniquement pour le forfait que vous souhaitez mettre en avant) > **Erreur fréquente :** Laisser la description vide. Une description claire réduit les questions et les demandes au support. ### Étape 2 : Type de forfait Choisissez le modèle de facturation. Vous verrez généralement des options comme : * **Abonnement mensuel** : Facturation récurrente mensuelle avec minutes et prix fixes. * **Achat unique** : Paiement unique pour une quantité fixe de minutes. * **Paiement à l’usage** : Facturation à la minute avec usage flexible. > **Important :** Les options disponibles peuvent varier selon votre compte ou votre formule. ### Étape 3 : Prix et minutes La configuration dépend du type de forfait. Pour un **abonnement mensuel**, on configure généralement : * **Minutes disponibles par mois** : Minutes incluses chaque mois (par exemple : **400**). * **Prix** : Montant mensuel (par exemple : **300**). Options possibles : * **Minutes supplémentaires** : Permet d’acheter des minutes en plus une fois les minutes incluses dépassées. * Si activé, définissez le **prix par minute supplémentaire** (par exemple : **0,30** par minute). * **Facturation annuelle** : Propose une facturation annuelle avec remise (si disponible). **Exemple pratique (abonnement mensuel)** * Minutes incluses : **400 minutes/mois** * Prix mensuel : **300/mois** * Minutes supplémentaires : **Activé** * Prix par minute supplémentaire : **0,30/min** Cela signifie : * Le client paie 300 par mois et reçoit 400 minutes. * S’il consomme 430 minutes, les 30 minutes en plus sont facturées à 0,30/min (30 × 0,30 = 9). ### Étape 4 : Configurer les fonctionnalités À l’étape des **fonctionnalités**, vous attribuez des valeurs aux fonctionnalités disponibles sur votre plateforme (souvent définies dans “Fonctions et capacités”). Selon la fonctionnalité, vous pouvez configurer : * Un interrupteur (oui/non) * Une limite numérique * Une valeur textuelle **Exemple pratique** * Fonctionnalité : “Minutes du forfait” * Valeur : **400** Si vous voyez peu de fonctionnalités ici, cela signifie généralement que seules quelques fonctionnalités ont été définies dans votre espace. ### Étape 5 : Vérifier et créer Avant de finaliser, un récapitulatif affiche : * Informations de base (nom, description, statut) * Type de forfait * Prix et minutes * Fonctionnalités Si quelque chose ne convient pas, utilisez l’option **modifier** dans la section concernée, puis vérifiez à nouveau. Quand tout est correct, créez le forfait. > **Astuce :** Vérifiez toujours “minutes incluses” et “prix” ensemble. Les erreurs les plus fréquentes viennent d’un mauvais alignement entre niveaux. ## Modifier un forfait existant Dans la liste, ouvrez le **menu à trois points** du forfait à modifier puis choisissez l’option pour **modifier**. Dans l’éditeur, vous verrez généralement des onglets comme : * **Informations de base** : Modifier le nom, la description et des options comme actif ou mis en avant. * **Fonctionnalités** : Ajuster les valeurs incluses dans le forfait. * **Prix et minutes** : Modifier les minutes incluses, le prix et les minutes supplémentaires.Capture : modification du prix et des minutes, y compris les minutes supplémentaires et un avertissement lié à la création d’un nouveau prix dans Stripe.
> **Important :** En changeant le prix, la plateforme peut créer un **nouveau prix dans Stripe**. Les abonnés existants peuvent conserver leur prix actuel et ne pas être affectés (cela peut varier selon votre configuration). ## Gestion de base (rechercher, copier l’identifiant, désactiver) Depuis la liste, vous pouvez généralement : * **Rechercher** un forfait par nom via la barre de recherche. * **Copier l’identifiant du forfait** pour le support ou des vérifications internes. * **Désactiver** un forfait pour qu’il ne soit plus proposé aux nouveaux utilisateurs. > **Erreur fréquente :** Désactiver un forfait sans en créer un de remplacement. Si vous devez le retirer, créez d’abord le nouveau forfait, puis désactivez l’ancien. # Abonnementpläne Source: https://support.callin.io/Automations/Whitelabel/SubscriptionsPlans-copied-4 Erstellen und verwalten Sie die Abonnementpläne, die Ihre White-Label-Konten ihren Unterkonten anbieten können. ## Wofür dieser Bereich gedacht ist Mit **Abonnementplänen** legt ein White-Label-Konto fest, welche Pläne für seine **Unterkonten** (Ihre Kundschaft) verfügbar sind. Diese Unterkonten können die Pläne anschließend ihren eigenen Endnutzerinnen und Endnutzern anbieten – zum Beispiel, um monatliche Minuten zu verkaufen, zusätzliche Minuten zu ermöglichen oder Stufen (Basis, Pro usw.) zu unterscheiden. In der Praxis hilft Ihnen dieser Bereich dabei: * Klare Stufen mit **inkludierten Minuten** und **Preis** zu erstellen. * Zu steuern, ob **zusätzliche Minuten** möglich sind, sobald die inkludierten Minuten aufgebraucht sind. * Einen Plan als „empfohlen“ hervorzuheben (falls diese Option in Ihrem Konto verfügbar ist). [Klicken Sie hier, um zu den Abonnementplänen zu gelangen](https://app.callin.io/cms/subscription-plans)Screenshot: Planübersicht mit Suche, Planerstellung und Aktionsmenü zur Verwaltung einzelner Pläne.
## Einen neuen Abonnementplan erstellen Unter **Abrechnung → Abonnementpläne** klicken Sie auf die Schaltfläche zum **Erstellen eines Plans**. Es öffnet sich ein Assistent mit mehreren Schritten. > **Tipp:** Definieren Sie Ihre Stufen und Preise vorab in einem Entwurf (z. B. „Basis: 400 Minuten/Monat für 300“). Das spart Zeit und reduziert spätere Korrekturen.Screenshot: Erster Schritt des Assistenten, in dem Sie den Plan benennen, beschreiben und die Verfügbarkeit festlegen.
### Schritt 1: Basisinformationen Tragen Sie das Nötigste ein: * **Planname**: Erforderlich. Das ist der Name, den Ihre Kundschaft sieht (z. B. **Basis**, **Pro**, **Business**). * **Beschreibung**: Empfohlen. Erklären Sie in einem Satz, was enthalten ist. * **Aktiv**: Wenn aktiviert, kann der Plan neuen Nutzerinnen und Nutzern angeboten werden. * **Hervorgehoben**: Wenn aktiviert, kann der Plan visuell betont werden (abhängig von Ihrer Konfiguration). **Praxisbeispiel** * Planname: **Basis** * Beschreibung: „Enthält 400 Minuten pro Monat. Ideal für kleine Teams, die Anrufabdeckung zu einem festen Preis möchten.“ * Aktiv: **Aktiviert** * Hervorgehoben: **Aktiviert** (nur für den Plan, den Sie hervorheben möchten) > **Häufiger Fehler:** Die Beschreibung leer lassen. Eine klare Beschreibung reduziert Rückfragen und Supportanfragen. ### Schritt 2: Plant yp Wählen Sie das Abrechnungsmodell. Üblicherweise gibt es Optionen wie: * **Monatliches Abonnement**: Wiederkehrende monatliche Abrechnung mit festen Minuten und festem Preis. * **Einmalkauf**: Einmalige Zahlung für eine feste Minutenmenge. * **Nutzungsbasierte Abrechnung**: Abrechnung pro Minute mit flexibler Nutzung. > **Wichtig:** Die verfügbaren Optionen können je nach Konto oder Tarif variieren. ### Schritt 3: Preis und Minuten Die Konfiguration hängt vom Plant yp ab. Bei einem **monatlichen Abonnement** ist üblich: * **Verfügbare Minuten pro Monat**: Inkludierte Minuten pro Monat (z. B. **400**). * **Preis**: Monatlicher Betrag (z. B. **300**). Mögliche Zusatzoptionen: * **Zusätzliche Minuten**: Ermöglicht den Kauf weiterer Minuten über die inkludierten Minuten hinaus. * Wenn aktiviert, legen Sie den **Preis pro zusätzlicher Minute** fest (z. B. **0,30** pro Minute). * **Jährliche Abrechnung**: Jährliche Abrechnung mit Rabatt (falls verfügbar). **Praxisbeispiel (monatliches Abonnement)** * Inkludierte Minuten: **400 Minuten/Monat** * Monatlicher Preis: **300/Monat** * Zusätzliche Minuten: **Aktiviert** * Preis pro zusätzlicher Minute: **0,30/Min** Das bedeutet: * Die Kundschaft zahlt 300 pro Monat und erhält 400 Minuten. * Bei 430 Minuten werden 30 Zusatzminuten mit 0,30/Min berechnet (30 × 0,30 = 9). ### Schritt 4: Funktionen konfigurieren Im Schritt **Funktionen** vergeben Sie Werte für die Funktionen, die in Ihrer Plattform definiert sind (häufig unter „Funktionen und Fähigkeiten“). Je nach Funktion können Sie einstellen: * Einen Schalter (ja/nein) * Ein numerisches Limit * Einen Textwert **Praxisbeispiel** * Funktion: „Planminuten“ * Wert: **400** Wenn hier nur wenige Funktionen angezeigt werden, wurden in Ihrem Bereich vermutlich nur wenige Funktionen definiert. ### Schritt 5: Prüfen und erstellen Vor dem Abschluss sehen Sie eine Zusammenfassung mit: * Basisinformationen (Name, Beschreibung, Status) * Plant yp * Preis und Minuten * Funktionen Wenn etwas nicht passt, nutzen Sie die Option **Bearbeiten** in der entsprechenden Sektion und prüfen Sie erneut. Wenn alles stimmt, erstellen Sie den Plan. > **Tipp:** Prüfen Sie „inkludierte Minuten“ und „Preis“ immer gemeinsam. Die häufigsten Fehler sind falsch zugeordnete Stufen. ## Einen bestehenden Plan bearbeiten In der Planliste öffnen Sie beim gewünschten Plan das **Drei-Punkte-Menü** und wählen die Option zum **Bearbeiten**. Im Editor sehen Sie typischerweise Reiter wie: * **Basisinformationen**: Name, Beschreibung sowie Optionen wie aktiv oder hervorgehoben. * **Funktionen**: Werte der enthaltenen Funktionen anpassen. * **Preis und Minuten**: Inkludierte Minuten, Preis und zusätzliche Minuten ändern.Screenshot: Bearbeitung von Preis und Minuten, inklusive zusätzlicher Minuten und einem Hinweis zur Erstellung eines neuen Preises in Stripe.
> **Wichtig:** Wenn Sie den Preis ändern, kann die Plattform einen **neuen Preis in Stripe** anlegen. Bestehende Abonnements können beim bisherigen Preis bleiben und nicht betroffen sein (abhängig von Ihrer Konfiguration). ## Grundverwaltung (suchen, ID kopieren, deaktivieren) In der Liste können Sie typischerweise: * Einen Plan über die Suchleiste **finden**. * Die **Plan-ID kopieren** (z. B. für Support oder interne Prüfungen). * Einen Plan **deaktivieren**, damit er neuen Nutzerinnen und Nutzern nicht mehr angeboten wird. > **Häufiger Fehler:** Einen Plan deaktivieren, ohne vorher einen Ersatz zu erstellen. Erstellen Sie zuerst den neuen Plan und deaktivieren Sie dann den alten. # Abonnements Source: https://support.callin.io/Automations/Whitelabel/SubscriptionsPlans-copied-9 Consultez l’abonnement de chaque client, y compris le forfait, le prix, les minutes, le statut et les dates. ## À quoi sert cette page La page **Abonnements** vous affiche une **vue en lecture seule** des abonnements de vos clients. Elle est conçue pour consulter (et non modifier), afin que vous puissiez répondre rapidement à des questions comme : * « Quel forfait a ce client ? » * « L’abonnement est-il actif, en retard de paiement ou annulé ? » * « Combien de minutes sont incluses et combien ont été utilisées ? » * « Quand l’abonnement a-t-il commencé et quand se termine-t-il ? » > **Astuce :** Les libellés exacts et les options disponibles peuvent varier selon votre compte, votre formule et la langue configurée. ## Comment utiliser la liste ### Rechercher des abonnements En haut, utilisez le champ **Search subscriptions…** pour retrouver rapidement un client (par exemple par e-mail ou par nom). ### Comprendre les colonnes Dans le tableau, vous verrez généralement : * **User** : l’identifiant du client (souvent l’e-mail, parfois le nom) * **Plan** : le nom du forfait (par exemple mensuel ou pay-as-you-go) * **Price** : le prix du forfait (si applicable et affiché pour ce forfait) * **Minutes** : minutes incluses et utilisation (par exemple « Used ») * **Status** : l’état actuel de l’abonnement * **Start Date** et **End Date** : la période de l’abonnement ## Exemples de statuts d’abonnement Dans la liste, des statuts comme ceux-ci peuvent apparaître : * **Active** : l’abonnement est actif * **Past Due** : un paiement est en retard * **Canceled** : l’abonnement a été annulé > **Important :** Si un client dit « j’ai payé » mais que le statut n’est pas **Active**, les vérifications les plus courantes sont : que vous consultiez le bon utilisateur/l’e-mail, et le statut actuel de l’abonnement sur cette page. # Téléphonie Source: https://support.callin.io/Automations/Whitelabel/Telephonie Comment fonctionne la section Téléphonie dans la White Label Console : acheter des numéros gérés, organiser ton inventaire, attribuer des numéros aux sous-comptes de tes clients et comprendre comment fonctionne la facturation des appels. La section **Téléphonie** est l'endroit où tu, en tant qu'administrateur White Label, obtiens les numéros de téléphone pour les agents qui tournent sur ta plateforme. Tu les achètes une seule fois dans ton inventaire, et depuis là tu attribues chaque numéro au sous-compte du client qui en a besoin. Tout ce que tu vois ici est organisé en trois onglets : * **Inventaire** — les numéros que tu possèdes déjà. * **Marketplace** — le catalogue depuis lequel tu achètes de nouveaux numéros. * **Facturation** — les règles qui s'appliquent à la facturation des appels. Dans les trois onglets, tu verras quatre cartes de résumé en haut. Elles te donnent une lecture rapide de ce à quoi sert cette section : * **Couverture mondiale des numéros** — tu peux parcourir des numéros de téléphone de nombreux pays depuis un seul endroit. Utile quand tes clients opèrent dans des régions différentes. * **Achat depuis la plateforme** — les numéros s'achètent directement via l'infrastructure Telnyx gérée par Callin. Tu n'as pas besoin d'avoir ton propre compte Telnyx. * **Attribution aux sous-comptes** — une fois qu'un numéro est dans ton inventaire, tu peux le rattacher au sous-compte de n'importe quel client de ton environnement. * **Arrondi de la première minute** — la facturation des appels applique un minimum d'une minute. L'onglet **Facturation** l'explique en détail. > **Astuce :** Ouvre les onglets dans l'ordre la première fois. **Marketplace** pour voir ce qui est disponible, **Inventaire** pour voir où atterriront les numéros que tu achètes, et **Facturation** pour savoir exactement comment tu es facturé. ## Inventaire L'onglet **Inventaire** est ton entrepôt personnel de numéros de téléphone. Chaque numéro que tu as déjà acheté vit ici, prêt à être attribué au sous-compte d'un client.Capture : l'onglet Inventaire. Les compteurs en haut te disent combien de numéros tu possèdes et combien sont déjà attribués.
La première fois que tu ouvres Téléphonie, ton inventaire sera vide. C'est normal — tu verras le message **Aucun numéro trouvé** tant que tu n'as pas fait ton premier achat. ### Compteurs En haut de l'onglet, deux compteurs te donnent l'état de l'inventaire d'un coup d'œil : * **Inventaire total** — le nombre total de téléphones que tu possèdes. * **Numéros attribués** — combien de ces numéros sont déjà rattachés au sous-compte d'un client. La différence entre les deux te dit combien de numéros sont encore libres et prêts à être attribués. ### Filtres et actions La barre de filtres t'aide à trouver un numéro précis quand l'inventaire grandit : * **Rechercher par numéro ou étiquette** — recherche par chiffres ou par l'étiquette que tu as donnée au numéro. * **Tous les pays** — limite la liste à un seul pays. * **Tous les types** — limite la liste à un seul type de numéro (les types sont expliqués dans l'onglet suivant). * **Actualiser** — recharge la liste. Utile juste après un achat si le nouveau numéro n'est pas encore apparu. * **Acheter un numéro** — un raccourci qui t'emmène directement à l'onglet **Marketplace**. > **Astuce :** Mets une étiquette claire à chaque numéro dès que tu l'achètes — par exemple, le nom de l'entreprise du client. Quand l'inventaire grandit, les étiquettes sont ce qui te fera gagner du temps. ### Attribuer un numéro à un sous-compte Une fois que le numéro est dans ton inventaire, tu peux l'attribuer à n'importe quel sous-compte de ton environnement. Le numéro reste dans ton inventaire ; l'attribution est ce qui autorise le client à l'utiliser dans ses agents. Chaque fois que tu attribues un numéro, le compteur **Numéros attribués** monte d'une unité, donc tu as toujours sous les yeux la part de ton inventaire qui est en usage. ## Marketplace L'onglet **Marketplace** est le catalogue des numéros disponibles à l'achat. C'est là que tu vas quand un client a besoin d'un nouveau numéro que tu n'as pas encore dans ton inventaire.Capture : l'onglet Marketplace. Chaque carte représente un numéro disponible et affiche tout ce que tu as besoin de savoir avant de l'acheter.
### Ce que montre chaque carte Chaque numéro apparaît sous forme de carte indépendante avec toutes les informations pour décider : * **Le numéro lui-même**, au format international. * **Drapeau du pays** et la ville ou la région (par exemple, `TX, BELLVILLE`). * **Opérateur** — le fournisseur qui fournit le numéro (par exemple, Telnyx). * **Type de numéro** — Local, Mobile ou Numéro vert. Expliqué ci-dessous. * **Capacités** — `VOICE` et/ou `SMS`, selon ce que le numéro prend en charge. * **Coût mensuel** — la redevance récurrente facturée chaque mois pendant que le numéro est actif. * **Coût de mise en service** — un frais ponctuel pour activer le numéro. * **Acheter** — le bouton pour l'acquérir. ### Types de numéro Quand tu achètes un numéro, tu ne choisis pas que des chiffres — tu choisis comment le perçoit la personne qui appelle et ce qu'il peut faire. Tu peux filtrer le catalogue par type : * **Local** — un numéro rattaché à une ville ou à une région précise (par exemple, des numéros américains associés à un État). La personne qui appelle voit un indicatif familier, ce qui aide aux taux de réponse pour les commerces de quartier. * **Mobile** — un numéro qui vit sur les réseaux mobiles. Dans certains pays, les mobiles et les fixes sont traités différemment, surtout pour les SMS. * **Numéro vert (toll-free)** — un numéro où la personne qui appelle ne paie rien ; le coût retombe sur le propriétaire de la ligne. Typique des lignes nationales de service client. > **Astuce :** Choisis le type de numéro en fonction de ce que reconnaîtra le client final de ton client. Un numéro local pour un commerce de quartier ; un numéro vert pour une ligne de support à couverture nationale. ### Recherche et filtres Le Marketplace dispose de la même barre de filtres que l'Inventaire : * **Rechercher par numéro ou étiquette** — cherche des chiffres précis. * **Tous les pays** — parcourt par pays. * **Tous les types** — limite à un seul type. * **Actualiser** — recharge le catalogue. > **Erreur fréquente :** Acheter un numéro sans regarder ses capacités. Un numéro uniquement `VOICE` ne peut pas envoyer de SMS, et un numéro uniquement `SMS` ne peut pas recevoir d'appels. Lis toujours les étiquettes de capacités sur la carte avant de cliquer sur **Acheter**. ### Ce qui se passe après l'achat Une fois que tu cliques sur **Acheter** sur une carte et que tu confirmes : * Le numéro est activé sur ton compte. * Il apparaît immédiatement dans ton onglet **Inventaire**. * Le coût mensuel commence à courir à partir de la date d'activation. * Tu peux attribuer le numéro au sous-compte de n'importe quel client quand tu veux. ## Facturation L'onglet **Facturation** explique les règles qui s'appliquent à chaque appel passé via la plateforme. Il n'y a rien à configurer ici — la page est informative, mais elle vaut la peine d'être lue une fois pour qu'aucune surprise n'apparaisse sur ta facture.Capture : l'onglet Facturation. Les deux blocs résument comment les minutes sont facturées et comment le provisioning des numéros est géré en coulisses.
### Arrondi de la première minute Chaque fois qu'un appel utilise l'opérateur de Callin et les numéros que tu as achetés via la plateforme, **la première minute est facturée comme une minute entière**, même si l'appel ne dure que quelques secondes. Après cette première minute, la facturation continue normalement en fonction de la durée réelle. En pratique : * Elle s'applique à la facturation côté plateforme entre toi (l'administrateur White Label) et Callin. * Elle s'applique à la facturation de revente que tu mets en place pour tes propres clients finaux. * La règle est appliquée automatiquement lors du calcul de la durée de l'appel — tu n'as rien à configurer. > **Important :** Tiens compte de cette règle quand tu fixes les prix pour tes clients. Si tu factures à la minute, ton unité minimale facturable doit aussi être d'au moins une minute. Sinon, les appels courts te coûteront plus que ce que tu encaisses. ### Provisioning géré Ce bloc confirme que toi, en tant qu'administrateur White Label, **tu n'as pas besoin de configurer Telnyx par toi-même**. Tout est pris en charge par le backend de Callin : * Les numéros sont provisionnés via l'infrastructure gérée par Callin. * Les achats se font directement à l'intérieur de la plateforme. * Les numéros achetés peuvent être attribués manuellement à n'importe quel sous-compte existant à tout moment. * Les règles de gestion des appels et de facturation restent cohérentes dans tout ton environnement. En résumé : tu te concentres sur la vente de numéros et de capacité à tes clients ; la complexité côté opérateur reste invisible. > **Astuce :** Si un client te demande la qualité des appels, la couverture ou comment le système est monté, tu peux répondre tranquillement que la plateforme tourne sur une infrastructure Telnyx gérée — il n'y a rien à intégrer de leur côté. # White Label Configuration Source: https://support.callin.io/Automations/Whitelabel/User Set up your branded app: name, custom domain and DNS, billing defaults, and your customer-facing appearance (colors, logos, favicon, and theme). ## What you’ll find on this page **White Label Configuration** is the control center for your branded app. At the top, you’ll see two tabs: * **Configuration**: core settings that affect how your app works (especially the domain and DNS). * **Appearance**: the visual identity your customers will see (colors, logos, favicon, and default theme). Open it here: [Open White Label Configuration](https://app.callin.io/cms/white-label-configuration)Screenshot: the “Configuration” tab where you define your app name, custom domain, and default settings like currency and language.
> **Important:** Some settings can vary depending on your plan and permissions. ## Configuration ### App Name **App Name** is what customers will recognize across the experience—like the label in the app navigation and page titles. A good rule: use the same name you use in your sales materials.\ Example: if you sell “Northwind Reception,” set the App Name to **Northwind Reception**. ### Custom Domain (recommended: use a subdomain) In **Custom Domain**, enter the domain customers will use to access the app. Callin recommends using a **subdomain you control**, for example: * `app.yourdomain.com` Why a subdomain matters: * Your **root domain** (like `yourdomain.com`) typically hosts your marketing website, landing pages, blog, and tracking scripts. * Keeping the product on `app.yourdomain.com` helps avoid conflicts and keeps your website setup independent. > **Tip:** Pick a simple subdomain your customers will remember: `app`, `portal`, or `dashboard`. ### DNS Configuration After you enter your custom domain, click **DNS Configuration**. This opens a modal with two ways to set up DNS: * **Provider** (automatic-assisted) * **Manual** (you add the records yourself) #### Provider (automatic-assisted setup) Use **Provider** when your DNS provider is supported. The idea is: you select your provider and Callin helps you discover what’s needed for your domain setup. What you do: 1. Open the **Provider** tab. 2. In **DNS Provider**, select your provider (examples you may see include **Cloudflare**, **GoDaddy**, and **Namecheap**). 3. Click **Discover**. What to expect: * Callin will attempt to guide you through the DNS setup for the domain you entered. * If something fails, you may see an error banner like “Something went wrong…”—that usually means the domain configuration or DNS records don’t match what’s expected yet.Screenshot: Provider-based DNS setup where you pick a DNS provider (e.g., Cloudflare/GoDaddy/Namecheap) and run Discover.
> **Common mistake:** DNS changes don’t apply instantly. If you just edited records, wait a bit and try again. #### Manual (add DNS records yourself) Use **Manual** if: * Your provider is not listed, or * Provider setup fails, or * You prefer to manage DNS yourself. On the **Manual** tab, Callin shows a small table of DNS records to create at your registrar/DNS provider. The table includes: * **Type** (for example, A or CNAME) * **Name** (for example, `@` or `app`) * **Value** (the destination) * **TTL** (often “300 or auto” depending on your provider) Your workflow looks like this: 1. Open **Manual**. 2. Add each DNS record exactly as shown in the table. 3. When the records are in place, click **Install SSL** to complete the setup.Screenshot: Manual DNS setup with the exact records to add and the “Install SSL” button to finalize.
> **Important:** Only click **Install SSL** after the DNS records are added and have propagated. Propagation time depends on your DNS provider. > **Tip:** If you’re unsure where to add records, search your DNS provider docs for “add A record” and “add CNAME record.” The field names in their UI can vary. ### Currency **Currency** is used for plan prices and billing display. Set it to match how you plan to charge customers (for example, EUR or USD). This is especially important if you will create **subscription plans** and charge through a payment provider (like Stripe), because customers expect consistency between pricing and billing. ### App Language **App Language** sets the default language your customers will see in the app interface. If you serve customers in multiple countries, choose the language that fits your primary audience. (Customers may still have different preferences depending on your setup and available languages.) ### Server location **Server location** lets you choose the geographic region where data is hosted to meet data residency and compliance requirements. If you work with customers that have strict requirements (healthcare, finance, public sector), align this setting with what you promised contractually. ### Privacy Policy and Terms of Use These fields let you link to your legal pages: * **Privacy Policy**: where you explain how you handle personal data. * **Terms of Use**: the rules customers agree to when using your service. > **Tip:** Even if you’re an agency, treat this like a product: publish these pages on your main website (root domain) and link them here. ## Appearance When your domain and core settings are ready, move to the **Appearance** tab to match the UI to your brand.Screenshot: the Appearance tab where you customize colors, upload logos and favicon, and choose a default theme.
### Colors You’ll typically see color controls such as: * **Primary Color**: used for buttons and key highlights in the app. * **Secondary Color**: used for accents and UI states. * **Email Primary Color**: the main accent color in transactional emails. * **Email CTA Button Color**: the color used for primary buttons and links inside emails. > **Tip:** If your brand already has a style guide, start with your primary brand color, then pick a secondary color that still looks good on both light and dark backgrounds. ### Logos (light and dark) You’ll usually upload: * **Logo**: for light backgrounds * **Dark Logo**: for dark backgrounds This matters because the same logo won’t always be readable across themes. > **Important:** Use **PNG** (ideally with transparent background) or SVG if available. If your logo appears tiny, it’s often because the image you uploaded includes a large white margin/border around the logo—Callin scales the full image down to fit. A tight, transparent PNG usually solves it. ### Favicon The **Favicon** is the small icon shown in the browser tab and bookmarks. Use an ICO or PNG sized for favicons (common sizes include 32×32 or 48×48). ### Default Theme **Default Theme** controls how the app looks by default: * **System**: follows the user’s device theme * **Light**: forces light mode * **Dark**: forces dark mode A practical approach: choose **System** if you want the app to feel native to each user’s preferences. # White-Label-Konfiguration Source: https://support.callin.io/Automations/Whitelabel/User-copied-1 Configure your branded app: name, custom domain and DNS, billing defaults, and your customer-facing appearance (colors, logos, favicon, and theme). ## Was Sie auf dieser Seite finden **White-Label-Konfiguration** ist das Kontrollzentrum für Ihre gebrandete App. Oben sehen Sie zwei Tabs: * **Konfiguration**: Grundeinstellungen, die beeinflussen, wie Ihre App funktioniert (vor allem Domain und DNS). * **Erscheinungsbild**: die visuelle Identität, die Ihre Kunden sehen (Farben, Logos, Favicon und Standard-Theme). Öffnen Sie die Seite hier: [White-Label-Konfiguration öffnen](https://app.callin.io/cms/white-label-configuration)Screenshot: der Tab „Configuration“, in dem Sie App-Name, eigene Domain und Standardwerte wie Währung und Sprache festlegen.
> **Wichtig:** Einige Einstellungen können je nach Plan und Berechtigungen variieren. ## Konfiguration ### App-Name Der **App-Name** ist das, was Kunden in der Erfahrung wiedererkennen – zum Beispiel in der Navigation und in Seitentiteln. Gute Faustregel: Verwenden Sie denselben Namen wie in Ihren Verkaufsunterlagen.\ Beispiel: Wenn Sie „Northwind Reception“ verkaufen, setzen Sie den App-Namen auf **Northwind Reception**. ### Eigene Domain (empfohlen: Subdomain verwenden) Unter **Eigene Domain** tragen Sie die Domain ein, über die Kunden die App öffnen. Callin empfiehlt eine **Subdomain, die Sie kontrollieren**, zum Beispiel: * `app.ihredomain.com` Warum eine Subdomain wichtig ist: * Ihre **Root-Domain** (z. B. `ihredomain.com`) hostet meist Ihre Marketing-Website, Landingpages, Blog und Tracking-Skripte. * Das Produkt auf `app.ihredomain.com` zu betreiben, hilft Konflikte zu vermeiden und hält Ihre Website unabhängig. > **Tipp:** Wählen Sie eine Subdomain, die sich leicht merken lässt: `app`, `portal` oder `dashboard`. ### DNS-Konfiguration Nachdem Sie Ihre Domain eingetragen haben, klicken Sie auf **DNS Configuration**. Es öffnet sich ein Dialog mit zwei Möglichkeiten für die DNS-Einrichtung: * **Provider** (automatisch/geführt) * **Manual** (Sie tragen die Records selbst ein) #### Provider (automatisch/geführt) Nutzen Sie **Provider**, wenn Ihr DNS-Anbieter unterstützt wird. Die Idee: Sie wählen den Anbieter aus und Callin hilft beim „Discover“-Schritt, damit die Domain korrekt eingerichtet wird. So gehen Sie vor: 1. Öffnen Sie den Tab **Provider**. 2. Wählen Sie unter **DNS Provider** Ihren Anbieter (Beispiele: **Cloudflare**, **GoDaddy** und **Namecheap**). 3. Klicken Sie auf **Discover**. Was Sie erwarten können: * Callin versucht, Sie durch die DNS-Einrichtung für die angegebene Domain zu führen. * Wenn etwas fehlschlägt, kann oben ein Fehlerbanner wie „Something went wrong…“ erscheinen; meist bedeutet das, dass Domain-Konfiguration oder DNS-Records noch nicht dem erwarteten Zustand entsprechen.Screenshot: DNS-Einrichtung per Provider, bei der Sie den Anbieter auswählen und Discover starten (geführter Flow).
> **Häufiger Fehler:** DNS-Änderungen greifen nicht sofort. Wenn Sie Records gerade erst geändert haben, warten Sie kurz und versuchen Sie es erneut. #### Manual (DNS-Records selbst anlegen) Nutzen Sie **Manual**, wenn: * Ihr Anbieter nicht in der Liste erscheint, oder * der Provider-Flow nicht funktioniert, oder * Sie DNS lieber selbst verwalten. Im Tab **Manual** zeigt Callin eine kleine Tabelle mit den DNS-Records, die Sie bei Ihrem Registrar/DNS-Anbieter anlegen müssen. Die Tabelle enthält: * **Type** (z. B. A oder CNAME) * **Name** (z. B. `@` oder `app`) * **Value** (das Ziel) * **TTL** (oft „300 or auto“, je nach Anbieter) Ihr Ablauf sieht so aus: 1. Öffnen Sie **Manual**. 2. Legen Sie jeden DNS-Record exakt so an, wie er in der Tabelle angezeigt wird. 3. Wenn alles erledigt ist, klicken Sie auf **Install SSL**, um abzuschließen.Screenshot: manuelle DNS-Einrichtung mit den exakt anzulegenden Records und dem Install SSL Button zum Finalisieren.
> **Wichtig:** Klicken Sie **Install SSL** erst, nachdem die DNS-Records angelegt wurden und propagiert sind. Die Propagationszeit hängt von Ihrem DNS-Anbieter ab. > **Tipp:** Wenn Sie nicht sicher sind, wo Sie Records anlegen, suchen Sie in der Doku Ihres Anbieters nach „A-Record anlegen“ und „CNAME-Record anlegen“. Die Feldnamen in deren UI können variieren. ### Währung Die **Währung** wird für Planpreise und die Darstellung der Abrechnung verwendet. Wählen Sie eine Währung, die zu Ihrer Preisstrategie passt (z. B. EUR oder USD). Das ist besonders wichtig, wenn Sie **Abo-Pläne** erstellen und über einen Zahlungsanbieter (wie Stripe) abrechnen, weil Kunden Konsistenz zwischen Preis und Abrechnung erwarten. ### App-Sprache Die **App-Sprache** legt die Standardsprache fest, die Ihre Kunden in der Oberfläche sehen. Wenn Sie Kunden in mehreren Ländern bedienen, wählen Sie die Sprache, die zu Ihrer Hauptzielgruppe passt. (Je nach Setup und verfügbaren Sprachen können Präferenzen dennoch variieren.) ### Serverstandort Mit dem **Serverstandort** wählen Sie die geografische Region, in der Daten gehostet werden, um Anforderungen an Datenresidenz und Compliance zu erfüllen. Wenn Sie Kunden mit strengen Vorgaben betreuen (Gesundheit, Finanzen, öffentlicher Sektor), stimmen Sie diese Einstellung mit Ihren vertraglichen Zusagen ab. ### Datenschutzrichtlinie und Nutzungsbedingungen Diese Felder verlinken Ihre rechtlichen Seiten: * **Datenschutzrichtlinie**: wie Sie personenbezogene Daten verarbeiten. * **Nutzungsbedingungen**: die Regeln, denen Kunden bei Nutzung Ihres Dienstes zustimmen. > **Tipp:** Auch wenn Sie eine Agentur sind: Behandeln Sie das wie ein Produkt. Veröffentlichen Sie diese Seiten auf Ihrer Hauptwebsite (Root-Domain) und verlinken Sie sie hier. ## Erscheinungsbild Wenn Domain und Grundeinstellungen stehen, wechseln Sie zum Tab **Erscheinungsbild**, damit die UI zu Ihrer Marke passt.Screenshot: der Appearance-Tab, in dem Sie Farben, Logos, Favicon und das Standard-Theme anpassen.
### Farben Typischerweise sehen Sie Farbeinstellungen wie: * **Primärfarbe**: für Buttons und wichtige Hervorhebungen. * **Sekundärfarbe**: für Akzente und UI-Status. * **E-Mail-Primärfarbe**: Haupt-Akzentfarbe in transaktionalen E-Mails. * **E-Mail-CTA-Buttonfarbe**: Farbe für primäre Buttons und Links in E-Mails. > **Tipp:** Wenn Sie eine Brand-Guideline haben, starten Sie mit Ihrer Primärfarbe und wählen Sie eine Sekundärfarbe, die sowohl auf hellen als auch auf dunklen Hintergründen gut aussieht. ### Logos (hell und dunkel) In der Regel laden Sie hoch: * **Logo**: für helle Hintergründe * **Dark Logo**: für dunkle Hintergründe Das ist wichtig, weil dasselbe Logo nicht immer in beiden Themes gut lesbar ist. > **Wichtig:** Verwenden Sie **PNG** (idealerweise mit transparentem Hintergrund) oder SVG, wenn verfügbar. Wenn Ihr Logo sehr klein wirkt, liegt das oft daran, dass die hochgeladene Datei viel weißen Rand/Leerraum enthält: Callin skaliert das gesamte Bild herunter, um es einzupassen. Ein eng zugeschnittenes, transparentes PNG löst das meist. ### Favicon Das **Favicon** ist das kleine Icon im Browser-Tab und in Lesezeichen. Verwenden Sie ICO oder PNG, das für Favicons optimiert ist (gängige Größen: 32×32 oder 48×48). ### Standard-Theme Das **Standard-Theme** bestimmt, wie die App standardmäßig aussieht: * **System**: folgt dem Theme des Geräts des Nutzers * **Hell**: erzwingt hellen Modus * **Dunkel**: erzwingt dunklen Modus Praktischer Ansatz: **System** wählen, wenn die App die Präferenzen jedes Nutzers respektieren soll. # Configuración de White Label Source: https://support.callin.io/Automations/Whitelabel/User-copied-2 Configura tu app con marca: nombre, dominio personalizado y DNS, valores por defecto de facturación y la apariencia de cara al cliente (colores, logos, favicon y tema). ## Qué encontrarás en esta página **Configuración de White Label** es el centro de control de tu app con marca. Arriba verás dos pestañas: * **Configuración**: ajustes base que afectan a cómo funciona tu app (sobre todo el dominio y el DNS). * **Apariencia**: la identidad visual que verán tus clientes (colores, logos, favicon y tema por defecto). Ábrela aquí: [Abrir Configuración de White Label](https://app.callin.io/cms/white-label-configuration)Captura: la pestaña de configuración donde defines el nombre, el dominio y valores por defecto como moneda e idioma.
> **Importante:** Algunas opciones pueden variar según tu plan y permisos. ## Configuración ### Nombre de la app El **Nombre de la app** es lo que el cliente reconocerá en la experiencia: por ejemplo, en la navegación y en los títulos de página. Regla práctica: usa el mismo nombre con el que vendes tu servicio.\ Ejemplo: si vendes “Northwind Reception”, pon **Northwind Reception** como nombre de la app. ### Dominio personalizado (recomendado: usar un subdominio) En **Dominio personalizado**, escribe el dominio desde el que tus clientes accederán a la app. Callin recomienda usar un **subdominio que controles**, por ejemplo: * `app.tudominio.com` Por qué es importante usar subdominio: * El **dominio raíz** (como `tudominio.com`) suele usarse para la web de marketing, landing pages, blog y otras herramientas. * Mantener el producto en `app.tudominio.com` evita interferencias y mantiene tu web principal independiente. > **Consejo:** Elige un subdominio fácil de recordar: `app`, `portal` o `dashboard`. ### Configuración de DNS Después de introducir el dominio, haz clic en **Configuración de DNS**. Se abre un modal con dos formas de configurar el DNS: * **Proveedor** (configuración asistida/automática) * **Manual** (añades los registros tú) #### Proveedor (configuración asistida/automática) Usa **Proveedor** cuando tu proveedor de DNS esté soportado. La idea es: eliges tu proveedor y Callin te ayuda a descubrir lo necesario para que el dominio funcione. Qué haces: 1. Entra en la pestaña **Proveedor**. 2. En **Proveedor de DNS**, selecciona tu proveedor (por ejemplo: **Cloudflare**, **GoDaddy** y **Namecheap**). 3. Pulsa **Discover**. Qué puedes esperar: * Callin intentará ayudarte a completar la configuración del DNS para el dominio que has indicado. * Si algo falla, puede aparecer una franja de error del estilo “Something went wrong…”; normalmente significa que la configuración del dominio o los registros DNS aún no coinciden con lo esperado.Captura: configuración de DNS por proveedor, donde eliges el proveedor y ejecutas Discover para un flujo asistido.
> **Error común:** Los cambios de DNS no se aplican al instante. Si acabas de modificar registros, espera un poco y vuelve a intentarlo. #### Manual (añadir los registros DNS tú mismo) Usa **Manual** si: * Tu proveedor no aparece en la lista, o * El flujo por proveedor no funciona, o * Prefieres gestionar el DNS manualmente. En la pestaña **Manual**, Callin te muestra una tabla con los registros DNS que debes crear en tu registrador/proveedor de DNS. La tabla incluye: * **Tipo** (por ejemplo, A o CNAME) * **Nombre** (por ejemplo, `@` o `app`) * **Valor** (destino del registro) * **TTL** (a menudo “300 o auto”, según el proveedor) Tu flujo sería: 1. Entra en **Manual**. 2. Añade cada registro DNS exactamente como aparece en la tabla. 3. Cuando estén añadidos, haz clic en **Instalar SSL** para finalizar.Captura: opción manual con los registros exactos a crear y el botón para instalar SSL al terminar.
> **Importante:** Pulsa **Instalar SSL** solo después de añadir los registros y de que hayan propagado. El tiempo de propagación depende de tu proveedor de DNS. > **Consejo:** Si no encuentras dónde añadir registros, busca en la documentación de tu proveedor “crear registro A” y “crear registro CNAME”. Los nombres de campos pueden variar. ### Moneda La **Moneda** se usa para precios de planes y visualización de facturación. Elige la moneda en la que vas a cobrar (por ejemplo, EUR o USD). Esto es especialmente importante si vas a crear **planes de suscripción** y cobrar mediante un proveedor de pagos (como Stripe), porque el cliente espera consistencia entre precio y cobro. ### Idioma de la app El **Idioma de la app** define el idioma por defecto que verán tus clientes en la interfaz. Si trabajas con clientes de varios países, selecciona el idioma que encaje con tu audiencia principal (según tu configuración y los idiomas disponibles). ### Ubicación del servidor La **Ubicación del servidor** te permite elegir la región donde se alojan los datos para cumplir requisitos de residencia de datos y normativas. Si trabajas con sectores sensibles (salud, finanzas, administración), alinea esta selección con lo que prometes a tus clientes. ### Política de privacidad y Términos de uso Estos campos sirven para enlazar tus páginas legales: * **Política de privacidad**: cómo gestionas los datos personales. * **Términos de uso**: condiciones que acepta el cliente al usar tu servicio. > **Consejo:** Aunque seas una agencia, trátalo como un producto: publica estas páginas en tu web principal (dominio raíz) y enlázalas aquí. ## Apariencia Cuando el dominio y los ajustes base estén listos, pasa a la pestaña **Apariencia** para que la interfaz encaje con tu marca.Captura: la pestaña Apariencia donde personalizas colores, logos, favicon y el tema por defecto.
### Colores Normalmente verás controles como: * **Color primario**: se usa para botones y destacados principales. * **Color secundario**: se usa para acentos y estados de la interfaz. * **Color primario de email**: color de acento en emails transaccionales. * **Color del botón CTA en email**: color de botones principales y enlaces dentro de emails. > **Consejo:** Si tienes guía de marca, empieza por el color principal y elige un secundario que se vea bien tanto en fondo claro como en fondo oscuro. ### Logos (claro y oscuro) Aquí normalmente subirás: * **Logo**: para fondos claros * **Logo oscuro**: para fondos oscuros Esto importa porque un mismo logo no siempre se lee bien en ambos temas. > **Importante:** Usa **PNG** (idealmente con fondo transparente) o SVG si lo tienes. Si el logo se ve muy pequeño, casi siempre es porque la imagen subida tiene mucho margen/blanco alrededor. Callin ajusta el tamaño al contenido total de la imagen; por eso un PNG transparente y “recortado” suele verse mucho mejor. ### Favicon El **Favicon** es el icono pequeño de la pestaña del navegador y los marcadores. Usa ICO o PNG preparado para favicon (tamaños habituales: 32×32 o 48×48). ### Tema por defecto El **Tema por defecto** controla cómo se verá la app inicialmente: * **Sistema**: sigue el tema del dispositivo del usuario * **Claro**: fuerza modo claro * **Oscuro**: fuerza modo oscuro Un enfoque práctico: usar **Sistema** para que la app respete las preferencias de cada usuario. # Configurazione White Label Source: https://support.callin.io/Automations/Whitelabel/User-copied-3 Configure your branded app: name, custom domain and DNS, billing defaults, and your customer-facing appearance (colors, logos, favicon, and theme). ## Cosa trovi in questa pagina **Configurazione White Label** è il centro di controllo della tua app con brand. In alto vedrai due schede: * **Configurazione**: impostazioni di base che influenzano come funziona la tua app (soprattutto dominio e DNS). * **Aspetto**: l’identità visiva che vedranno i tuoi clienti (colori, loghi, favicon e tema predefinito). Aprila qui: [Apri Configurazione White Label](https://app.callin.io/cms/white-label-configuration)Schermata: la scheda “Configuration” dove definisci nome app, dominio personalizzato e impostazioni predefinite come valuta e lingua.
> **Importante:** Alcune impostazioni possono variare in base al tuo piano e ai permessi. ## Configurazione ### Nome dell’app Il **Nome dell’app** è ciò che i clienti riconosceranno nell’esperienza: ad esempio nella navigazione e nei titoli delle pagine. Regola pratica: usa lo stesso nome che utilizzi nei materiali di vendita.\ Esempio: se vendi “Northwind Reception”, imposta il nome dell’app su **Northwind Reception**. ### Dominio personalizzato (consigliato: usare un sottodominio) In **Dominio personalizzato**, inserisci il dominio che i clienti useranno per accedere all’app. Callin consiglia di usare un **sottodominio che controlli**, ad esempio: * `app.iltuodominio.com` Perché il sottodominio è importante: * Il tuo **dominio principale** (come `iltuodominio.com`) di solito ospita il sito marketing, le landing page, il blog e gli script di tracciamento. * Tenere il prodotto su `app.iltuodominio.com` aiuta a evitare conflitti e mantiene il sito indipendente. > **Consiglio:** Scegli un sottodominio facile da ricordare: `app`, `portal` o `dashboard`. ### DNS Configuration Dopo aver inserito il dominio personalizzato, clicca su **DNS Configuration**. Si apre una finestra con due modi per configurare il DNS: * **Provider** (configurazione guidata/automatica) * **Manual** (aggiungi i record manualmente) #### Provider (configurazione guidata/automatica) Usa **Provider** quando il tuo provider DNS è supportato. L’idea: selezioni il provider e Callin ti aiuta a “scoprire” cosa serve per completare la configurazione del dominio. Cosa fai: 1. Apri la scheda **Provider**. 2. In **DNS Provider**, seleziona il tuo provider (esempi: **Cloudflare**, **GoDaddy** e **Namecheap**). 3. Clicca su **Discover**. Cosa aspettarti: * Callin proverà a guidarti per completare la configurazione DNS del dominio che hai indicato. * Se qualcosa non va, potresti vedere un banner di errore tipo “Something went wrong…”; di solito significa che la configurazione del dominio o i record DNS non corrispondono ancora a quanto atteso.Schermata: configurazione DNS per provider, dove scegli il provider ed esegui Discover per un flusso guidato.
> **Errore comune:** Le modifiche DNS non sono immediate. Se hai appena aggiornato i record, aspetta un po’ e riprova. #### Manual (aggiungere i record DNS manualmente) Usa **Manual** se: * il tuo provider non è presente nell’elenco, oppure * il flusso tramite provider non funziona, oppure * preferisci gestire il DNS manualmente. Nella scheda **Manual**, Callin mostra una piccola tabella con i record DNS da creare presso il tuo registrar/provider DNS. La tabella include: * **Type** (ad esempio A o CNAME) * **Name** (ad esempio `@` o `app`) * **Value** (la destinazione) * **TTL** (spesso “300 or auto” a seconda del provider) Il tuo flusso è questo: 1. Apri **Manual**. 2. Aggiungi ogni record DNS esattamente come mostrato nella tabella. 3. Quando hai finito, clicca su **Install SSL** per completare.Schermata: configurazione DNS manuale con i record esatti da aggiungere e il pulsante Install SSL per finalizzare.
> **Importante:** Clicca su **Install SSL** solo dopo aver aggiunto i record DNS e dopo che si sono propagati. I tempi di propagazione dipendono dal provider DNS. > **Consiglio:** Se non sai dove aggiungere i record, cerca nella documentazione del tuo provider “aggiungere record A” e “aggiungere record CNAME”. I nomi dei campi nella loro interfaccia possono variare. ### Valuta La **Valuta** viene usata per i prezzi dei piani e per la visualizzazione della fatturazione. Impostala in base a come intendi addebitare i clienti (ad esempio EUR o USD). È particolarmente importante se creerai **piani di abbonamento** e addebiterai tramite un provider di pagamento (come Stripe), perché i clienti si aspettano coerenza tra prezzi e fatturazione. ### Lingua dell’app La **Lingua dell’app** imposta la lingua predefinita che i clienti vedranno nell’interfaccia. Se servi clienti in più Paesi, scegli la lingua più adatta al tuo pubblico principale. (Le preferenze possono comunque variare in base alla configurazione e alle lingue disponibili.) ### Posizione del server La **Posizione del server** ti consente di scegliere l’area geografica in cui i dati vengono ospitati per rispettare requisiti di residenza dei dati e conformità. Se lavori con clienti che hanno requisiti rigorosi (sanità, finanza, settore pubblico), allinea questa impostazione a ciò che hai promesso a livello contrattuale. ### Informativa sulla privacy e Termini di utilizzo Questi campi ti permettono di collegare le tue pagine legali: * **Informativa sulla privacy**: come gestisci i dati personali. * **Termini di utilizzo**: le regole che i clienti accettano quando usano il tuo servizio. > **Consiglio:** Anche se sei un’agenzia, trattalo come un prodotto: pubblica queste pagine sul sito principale (dominio root) e collegale qui. ## Aspetto Quando dominio e impostazioni di base sono pronti, passa alla scheda **Aspetto** per allineare l’interfaccia al tuo brand.Schermata: la scheda Appearance dove personalizzi colori, loghi, favicon e il tema predefinito.
### Colori Di solito vedrai controlli colore come: * **Colore primario**: usato per pulsanti ed evidenziazioni principali. * **Colore secondario**: usato per accenti e stati dell’interfaccia. * **Colore primario email**: colore di accento principale nelle email transazionali. * **Colore pulsante CTA email**: colore usato per pulsanti principali e link nelle email. > **Consiglio:** Se hai già una brand guideline, parti dal colore principale e scegli un secondario che funzioni bene sia su sfondi chiari sia su sfondi scuri. ### Loghi (chiaro e scuro) Di solito caricherai: * **Logo**: per sfondi chiari * **Dark Logo**: per sfondi scuri Questo è importante perché lo stesso logo non è sempre leggibile su entrambi i temi. > **Importante:** Usa **PNG** (idealmente con sfondo trasparente) o SVG se disponibile. Se il logo appare molto piccolo, spesso è perché l’immagine caricata ha un grande margine/cornice bianca attorno al logo: Callin riduce l’intera immagine per adattarla. Un PNG trasparente e ben “ritagliato” di solito risolve. ### Favicon Il **Favicon** è la piccola icona mostrata nella scheda del browser e nei preferiti. Usa un ICO o un PNG adatto ai favicon (dimensioni comuni: 32×32 o 48×48). ### Tema predefinito Il **Tema predefinito** controlla l’aspetto dell’app in modo predefinito: * **Sistema**: segue il tema del dispositivo dell’utente * **Chiaro**: forza la modalità chiara * **Scuro**: forza la modalità scura Un approccio pratico: scegliere **Sistema** se vuoi che l’app rispetti le preferenze di ogni utente. # Avant de commencer la configuration de votre White Label Source: https://support.callin.io/Automations/Whitelabel/User-copied-4 Comprenez ce que signifie le White Label dans Callin, où y accéder depuis la Console et ce que vous pouvez gérer en tant qu’agence avant de commencer. ## Ce que signifie le « White Label » dans Callin Le **White Label** dans Callin est conçu pour les équipes (en particulier les **agences**) qui souhaitent **revendre la technologie de Callin sous leur propre marque**. Au lieu d’envoyer vos clients vers « Callin », vous pouvez présenter l’expérience comme *votre produit* : votre nom, votre domaine, votre identité visuelle et votre modèle de facturation, tandis que Callin fait tourner l’infrastructure en coulisses. > **Conseil :** Pensez-y comme à « Callin à l’intérieur, votre marque à l’extérieur ». ## Où accéder au White Label Toutes les options White Label se gèrent depuis la **Console**. 1. Dans l’application principale, cliquez sur **Console** en haut à droite. 2. Ouvrez ensuite **Configuration White Label**. Pour y accéder, cliquez ici : [Ouvrir la configuration White Label](https://app.callin.io/cms/white-label-configuration)Capture : la page de configuration White Label dans la Console, où vous définissez le nom de votre app, votre domaine et d’autres valeurs par défaut visibles par vos clients.
> **Important :** Certaines options peuvent varier selon votre offre et vos permissions. ## Ce que vous pouvez faire en tant qu’agence avec le White Label Le White Label est conçu pour vous permettre d’opérer comme une entreprise produit, même si vous êtes une agence. Avec la Console, vous pouvez : * **Proposer une plateforme à votre marque** à vos clients (votre nom et votre présentation, pas « Callin »). * **Utiliser votre propre domaine** pour que vos clients aient l’impression d’être dans votre écosystème. * **Créer des plans d’abonnement** que vous vendez à vos clients (par exemple « Starter », « Pro », « Enterprise »). * **Encaisser via Stripe** (une fois connecté) pour gérer la facturation selon votre organisation. * **Gérer vos clients et votre équipe** au même endroit, sans multiplier les outils. ### Un exemple réaliste Imaginez que vous dirigez une agence appelée **Northwind Voice Studio**. Vous voulez vendre un produit « réceptionniste IA » à des cliniques locales. * Votre client voit la plateforme sous la marque **Northwind Reception**. * Il y accède via un domaine comme **app.northwindreception.com**. * Vous lui vendez un **abonnement mensuel** que vous avez créé dans la Console. * Les paiements passent par **Stripe**, et vous gérez l’accès du client depuis **Utilisateurs**. ## Aperçu rapide de ce qui est configurable dans la Console Voici une vue d’ensemble des zones que vous utiliserez le plus souvent pour exploiter un White Label. ### Configuration White Label C’est ici que vous définissez les éléments essentiels visibles côté client pour votre app à votre marque. * **Nom de l’app** : le nom affiché dans la navigation et les titres de pages. * **Domaine personnalisé** : le domaine/sous-domaine que vos clients utiliseront (la configuration DNS se fait via l’action **Configuration DNS**). * **Devise** : utilisée pour les prix et l’affichage de la facturation. * **Langue de l’app** : la langue par défaut de l’expérience client. * **Onglet Apparence** : permet d’ajuster la présentation visuelle (les options disponibles peuvent varier selon le compte/l’offre). ### Intégrations Les intégrations connectent votre White Label aux services tiers essentiels. Dans la Console, vous pouvez voir des intégrations comme : * **Stripe** (paiements) * **Twilio** (SMS et appels vocaux ; parfois indiqué comme requis) * **SendGrid** (envoi/automatisation d’emails) * **Intercom**, **Brevo Chat** (communication client) * **Clés API d’analytique et de suivi** (suivi et attribution) > **Conseil :** Si la facturation fait partie de votre modèle, connectez Stripe tôt pour tester votre parcours client de bout en bout. ### Utilisateurs C’est votre zone de gestion des clients et des membres de l’équipe. Ici, vous pouvez généralement : * Rechercher et consulter des utilisateurs * Créer des utilisateurs * Gérer l’accès et le statut ### Abonnements Cette section vous permet de **consulter et gérer les abonnements** de vos clients.\ Elle vous aide à savoir qui est abonné et à quel plan (selon votre configuration et vos intégrations). ### Plans d’abonnement C’est ici que vous créez et gérez les plans que vous vendez. Vous y verrez généralement : * Nom du plan * Périodicité de facturation (par exemple mensuelle) * Prix * Statut (actif/inactif) ### Analytique UTM L’analytique UTM vous aide à comprendre **l’attribution marketing** — par exemple, quelles sources ou campagnes ont généré des inscriptions. Vous pouvez généralement : * Filtrer par période * Exporter les résultats (par exemple en CSV) * Consulter des répartitions comme la source et la campagne (lorsque des données existent) ## Ordre de configuration recommandé (pour ne rien oublier) Pour un premier lancement en White Label, cet ordre facilite une mise en place fluide : 1. Définissez le **Nom de l’app**, la **Devise** et la **Langue de l’app** dans **Configuration White Label**. 2. Ajoutez votre **Domaine personnalisé** et terminez la **Configuration DNS**. 3. Connectez les **Intégrations** indispensables (surtout Stripe si vous facturez vos clients). 4. Créez vos **Plans d’abonnement**. 5. Ajoutez/gérez vos clients et votre équipe dans **Utilisateurs**. 6. Suivez l’acquisition et les canaux dans **Analytique UTM**. # Configuration White Label Source: https://support.callin.io/Automations/Whitelabel/User-copied-5 Configure your branded app: name, custom domain and DNS, billing defaults, and your customer-facing appearance (colors, logos, favicon, and theme). ## Ce que vous trouverez sur cette page **Configuration White Label** est le centre de contrôle de votre application sous votre marque. En haut, vous verrez deux onglets : * **Configuration** : les paramètres de base qui influencent le fonctionnement de votre app (surtout le domaine et le DNS). * **Apparence** : l’identité visuelle que verront vos clients (couleurs, logos, favicon et thème par défaut). Ouvrez-la ici : [Ouvrir la configuration White Label](https://app.callin.io/cms/white-label-configuration)Capture : l’onglet « Configuration » où vous définissez le nom de l’app, le domaine personnalisé et des valeurs par défaut comme la devise et la langue.
> **Important :** Certains paramètres peuvent varier selon votre offre et vos permissions. ## Configuration ### Nom de l’app Le **Nom de l’app** est ce que vos clients reconnaîtront dans l’expérience : par exemple dans la navigation et dans les titres de page. Bonne règle : utilisez le même nom que dans vos supports de vente.\ Exemple : si vous vendez « Northwind Reception », définissez le nom de l’app sur **Northwind Reception**. ### Domaine personnalisé (recommandé : utiliser un sous-domaine) Dans **Domaine personnalisé**, saisissez le domaine que vos clients utiliseront pour accéder à l’app. Callin recommande d’utiliser un **sous-domaine que vous contrôlez**, par exemple : * `app.votredomaine.com` Pourquoi un sous-domaine est important : * Votre **domaine racine** (comme `votredomaine.com`) héberge généralement votre site marketing, vos landing pages, votre blog et vos scripts de suivi. * Garder le produit sur `app.votredomaine.com` aide à éviter les conflits et à maintenir votre site indépendant. > **Conseil :** Choisissez un sous-domaine facile à mémoriser : `app`, `portal` ou `dashboard`. ### Configuration DNS Après avoir saisi votre domaine personnalisé, cliquez sur **Configuration DNS**. Cela ouvre une fenêtre avec deux façons de configurer le DNS : * **Fournisseur** (configuration assistée/automatique) * **Manuel** (vous ajoutez vous-même les enregistrements) #### Fournisseur (configuration assistée/automatique) Utilisez **Fournisseur** lorsque votre fournisseur DNS est pris en charge. L’idée : vous sélectionnez votre fournisseur et Callin vous aide à « découvrir » ce qu’il faut pour que votre domaine fonctionne. Ce que vous faites : 1. Ouvrez l’onglet **Fournisseur**. 2. Dans **Fournisseur DNS**, sélectionnez votre fournisseur (exemples : **Cloudflare**, **GoDaddy** et **Namecheap**). 3. Cliquez sur **Discover**. À quoi vous attendre : * Callin tentera de vous guider pour finaliser la configuration DNS du domaine que vous avez indiqué. * En cas d’échec, vous pouvez voir une bannière d’erreur du type « Something went wrong… » ; cela signifie généralement que la configuration du domaine ou les enregistrements DNS ne correspondent pas encore à ce qui est attendu.Capture : configuration DNS par fournisseur, où vous choisissez le fournisseur et lancez Discover pour un flux assisté.
> **Erreur fréquente :** Les changements DNS ne s’appliquent pas instantanément. Si vous venez de modifier des enregistrements, attendez un peu puis réessayez. #### Manuel (ajouter vous-même les enregistrements DNS) Utilisez **Manuel** si : * votre fournisseur n’apparaît pas dans la liste, ou * le flux par fournisseur échoue, ou * vous préférez gérer le DNS vous-même. Sur l’onglet **Manuel**, Callin affiche un petit tableau des enregistrements DNS à créer chez votre registrar/fournisseur DNS. Le tableau comprend : * **Type** (par exemple, A ou CNAME) * **Nom** (par exemple, `@` ou `app`) * **Valeur** (la destination) * **TTL** (souvent « 300 ou auto » selon votre fournisseur) Votre procédure ressemble à ceci : 1. Ouvrez **Manuel**. 2. Ajoutez chaque enregistrement DNS exactement comme indiqué dans le tableau. 3. Une fois terminé, cliquez sur **Install SSL** pour finaliser.Capture : configuration DNS manuelle avec les enregistrements exacts à ajouter et le bouton Install SSL pour finaliser.
> **Important :** Ne cliquez sur **Install SSL** qu’après avoir ajouté les enregistrements DNS et après leur propagation. Le temps de propagation dépend de votre fournisseur DNS. > **Conseil :** Si vous ne savez pas où ajouter les enregistrements, cherchez dans la documentation de votre fournisseur « ajouter un enregistrement A » et « ajouter un enregistrement CNAME ». Les libellés des champs peuvent varier. ### Devise La **Devise** est utilisée pour les prix des plans et l’affichage de la facturation. Définissez-la pour qu’elle corresponde à la façon dont vous comptez facturer vos clients (par exemple EUR ou USD). C’est particulièrement important si vous allez créer des **plans d’abonnement** et facturer via un prestataire de paiement (comme Stripe), car les clients attendent une cohérence entre le prix et la facturation. ### Langue de l’app La **Langue de l’app** définit la langue par défaut que verront vos clients dans l’interface. Si vous servez des clients dans plusieurs pays, choisissez la langue qui correspond à votre audience principale. (Les préférences peuvent ensuite varier selon votre configuration et les langues disponibles.) ### Emplacement du serveur L’**Emplacement du serveur** vous permet de choisir la région géographique où les données sont hébergées afin de répondre aux exigences de résidence des données et de conformité. Si vous travaillez avec des clients ayant des exigences strictes (santé, finance, secteur public), alignez ce paramètre sur ce que vous avez promis contractuellement. ### Politique de confidentialité et Conditions d’utilisation Ces champs permettent de lier vos pages légales : * **Politique de confidentialité** : comment vous gérez les données personnelles. * **Conditions d’utilisation** : les règles que les clients acceptent lorsqu’ils utilisent votre service. > **Conseil :** Même si vous êtes une agence, traitez cela comme un produit : publiez ces pages sur votre site principal (domaine racine) et liez-les ici. ## Apparence Une fois votre domaine et vos paramètres de base prêts, passez à l’onglet **Apparence** pour aligner l’interface avec votre marque.Capture : l’onglet Apparence où vous personnalisez les couleurs, les logos, le favicon et le thème par défaut.
### Couleurs Vous verrez généralement des contrôles de couleur comme : * **Couleur principale** : utilisée pour les boutons et les mises en avant clés. * **Couleur secondaire** : utilisée pour les accents et les états de l’interface. * **Couleur principale des emails** : couleur d’accent principale dans les emails transactionnels. * **Couleur du bouton CTA des emails** : couleur utilisée pour les boutons principaux et les liens dans les emails. > **Conseil :** Si votre marque a déjà une charte, commencez par votre couleur principale, puis choisissez une couleur secondaire qui reste lisible sur fond clair comme sur fond sombre. ### Logos (clair et sombre) Vous téléverserez généralement : * **Logo** : pour les arrière-plans clairs * **Dark Logo** : pour les arrière-plans sombres C’est important, car un même logo n’est pas toujours lisible sur les deux thèmes. > **Important :** Utilisez du **PNG** (idéalement avec un fond transparent) ou du SVG si disponible. Si votre logo apparaît minuscule, c’est souvent parce que l’image téléversée contient une grande marge/cadre blanc autour du logo : Callin réduit l’image entière pour l’adapter. Un PNG transparent bien « recadré » règle généralement le problème. ### Favicon Le **Favicon** est la petite icône affichée dans l’onglet du navigateur et les favoris. Utilisez un ICO ou un PNG adapté (tailles courantes : 32×32 ou 48×48). ### Thème par défaut Le **Thème par défaut** définit l’apparence initiale de l’app : * **Système** : suit le thème de l’appareil de l’utilisateur * **Clair** : force le mode clair * **Sombre** : force le mode sombre Une approche pratique : choisir **Système** si vous souhaitez que l’app respecte les préférences de chaque utilisateur. # Before you start configuring your White Label Source: https://support.callin.io/Automations/Whitelabel/WhiteLabel Understand what White Label means in Callin, where to access it from the Console, and what you can manage as an agency before you begin. ## What “White Label” means in Callin A **White Label** in Callin is designed for teams (especially **agencies**) who want to **resell Callin’s technology under their own brand**. Instead of sending your customers to “Callin,” you can present the experience as *your product*: your name, your domain, your look and feel, and your billing model—while Callin runs the underlying infrastructure. > **Tip:** Think of it as “Callin on the inside, your brand on the outside.” ## Where you access White Label All White Label options are managed from the **Console**. 1. In the main app, click **Console** in the top-right corner. 2. Then open **White Label Configuration**. To go, click here: [Open White Label Configuration](https://app.callin.io/cms/white-label-configuration)Screenshot: the White Label Configuration page in the Console, where you set your app name, domain, and other customer-facing defaults.
> **Important:** Some options can vary depending on your plan and permissions. ## What you can do as an agency with White Label White Label is built to help you operate like a product company—even if you’re an agency. With the Console, you can: * **Offer a branded platform** to your customers (your name and presentation, not “Callin”). * **Use your own domain** so customers feel like they’re inside your ecosystem. * **Create subscription plans** you sell to customers (for example, “Starter,” “Pro,” “Enterprise”). * **Charge customers through Stripe** (when connected) so billing happens under your workflow. * **Manage customers and team members** from one place, without juggling multiple tools. ### A realistic example Imagine you run an agency called **Northwind Voice Studio**. You want to sell an “AI receptionist” product to local clinics. * Your customer sees the platform branded as **Northwind Reception**. * They access it through a domain like **app.northwindreception.com**. * You sell them a **monthly plan** you created in the Console. * Payments run through **Stripe**, and you manage the customer’s access from **Users**. ## A quick tour of what’s configurable in the Console Below is a high-level overview of the areas you’ll typically use when running White Label.Screenshot: die White-Label-Konfigurationsseite in der Konsole, auf der Sie App-Name, Domain und weitere kundenseitige Standardwerte festlegen.
> **Wichtig:** Einige Optionen können je nach Plan und Berechtigungen variieren. ## Was Sie als Agentur mit White Label tun können White Label ist dafür gemacht, dass Sie wie ein Produktunternehmen arbeiten können – auch wenn Sie eine Agentur sind. In der Konsole können Sie: * **Eine Plattform unter Ihrer Marke anbieten** (Ihr Name und Ihr Auftritt, nicht „Callin“). * **Ihre eigene Domain nutzen**, damit sich Ihre Kunden in Ihrem Ökosystem zuhause fühlen. * **Abo-Pläne erstellen**, die Sie an Ihre Kunden verkaufen (z. B. „Starter“, „Pro“, „Enterprise“). * **Über Stripe abrechnen** (nachdem es verbunden ist), sodass die Zahlungsabwicklung Ihrem Prozess folgt. * **Kunden und Teammitglieder zentral verwalten**, ohne mehrere Tools jonglieren zu müssen. ### Ein realistisches Beispiel Stellen Sie sich vor, Sie führen eine Agentur namens **Northwind Voice Studio**. Sie möchten ein „KI-Rezeption“-Produkt an lokale Kliniken verkaufen. * Ihr Kunde sieht die Plattform gebrandet als **Northwind Reception**. * Er greift über eine Domain wie **app.northwindreception.com** darauf zu. * Sie verkaufen ihm einen **Monatsplan**, den Sie in der Konsole erstellt haben. * Zahlungen laufen über **Stripe**, und den Zugang verwalten Sie unter **Benutzer**. ## Kurzer Überblick über konfigurierbare Bereiche in der Konsole Unten sehen Sie eine Übersicht auf hoher Ebene der Bereiche, die Sie beim Betrieb eines White Labels typischerweise verwenden. ### White-Label-Konfiguration Hier legen Sie die Grundlagen fest, die Ihre Kunden in Ihrer gebrandeten App sehen. * **App-Name**: der Name, der z. B. in Navigation und Seitentiteln erscheint. * **Eigene Domain**: die Domain/Subdomain, über die Ihre Kunden die App öffnen (DNS richten Sie über die Aktion **DNS-Konfiguration** ein). * **Währung**: wird für Preise und die Darstellung der Abrechnung genutzt. * **App-Sprache**: die Standardsprache der App für Ihre Kunden. * **Tab Erscheinungsbild**: passt die visuelle Darstellung an (verfügbare Optionen können je nach Konto/Plan variieren). ### Integrationen Integrationen verbinden Ihr White Label mit wichtigen Drittanbieterdiensten. In der Konsole können Integrationen wie diese angezeigt werden: * **Stripe** (Zahlungen) * **Twilio** (SMS und Sprachanrufe; manchmal als erforderlich markiert) * **SendGrid** (E-Mail-Versand/Automatisierung) * **Intercom**, **Brevo Chat** (Kundenkommunikation) * **API-Schlüssel für Analytik & Tracking** (Tracking und Attribution) > **Tipp:** Wenn Abrechnung Teil Ihres Modells ist, verbinden Sie Stripe früh, um den gesamten Kundenfluss testen zu können. ### Benutzer Das ist Ihr Bereich zur Verwaltung von Kunden und Teammitgliedern. Hier können Sie typischerweise: * Benutzer suchen und prüfen * Benutzer erstellen * Zugriff und Status verwalten ### Abonnements Hier **sehen und verwalten Sie Abonnements** Ihrer Kunden.\ So behalten Sie im Blick, wer abonniert ist und auf welchem Plan (abhängig von Ihrer Konfiguration und den Integrationen). ### Abo-Pläne Hier erstellen und verwalten Sie die Pläne, die Sie verkaufen. Typische Elemente eines Plans: * Planname * Abrechnungsrhythmus (z. B. monatlich) * Preis * Status (aktiv/inaktiv) ### UTM-Analytik UTM-Analytik hilft Ihnen, **Marketing-Attribution** zu verstehen – z. B. welche Quellen oder Kampagnen Registrierungen ausgelöst haben. Typischerweise können Sie: * Nach Datumsbereich filtern * Ergebnisse exportieren (z. B. als CSV) * Aufschlüsselungen nach Quelle und Kampagne ansehen (wenn Daten vorhanden sind) ## Empfohlene Einrichtungsreihenfolge (damit nichts fehlt) Für den ersten White-Label-Launch sorgt diese Reihenfolge für einen reibungslosen Ablauf: 1. Legen Sie **App-Name**, **Währung** und **App-Sprache** in der **White-Label-Konfiguration** fest. 2. Hinterlegen Sie Ihre **eigene Domain** und schließen Sie die **DNS-Konfiguration** ab. 3. Verbinden Sie wichtige **Integrationen** (vor allem Stripe, wenn Sie Kunden abrechnen). 4. Erstellen Sie Ihre **Abo-Pläne**. 5. Fügen Sie Kunden und Team unter **Benutzer** hinzu bzw. verwalten Sie sie dort. 6. Verfolgen Sie Akquise und Kanäle in der **UTM-Analytik**. # Antes de empezar la configuración de tu White Label Source: https://support.callin.io/Automations/Whitelabel/WhiteLabel-copied-2 Entiende qué significa White Label en Callin, dónde se gestiona desde la Consola y qué podrás administrar como agencia antes de empezar. ## Qué significa “White Label” en Callin Un **White Label** en Callin está pensado para equipos (especialmente **agencias**) que quieren **revender la tecnología de Callin bajo su propia marca**. En lugar de enviar a tus clientes a “Callin”, puedes presentar la experiencia como *tu producto*: tu nombre, tu dominio, tu apariencia y tu forma de facturar—mientras Callin se encarga de la infraestructura. > **Consejo:** Piensa en ello como “Callin por dentro, tu marca por fuera”. ## Dónde se accede al White Label Todas las opciones de White Label se gestionan desde la **Consola**. 1. En la app principal, haz clic en **Consola** en la esquina superior derecha. 2. Después, abre **Configuración de White Label**. Para ir, haz clic aquí: [Abrir Configuración de White Label](https://app.callin.io/cms/white-label-configuration)Captura: la página de configuración de White Label en la Consola, donde defines el nombre de la app, el dominio y otros valores por defecto de cara al cliente.
> **Importante:** Algunas opciones pueden variar según tu plan y permisos. ## Qué puedes hacer como agencia con White Label White Label está diseñado para que puedas operar como una empresa de producto—aunque seas una agencia. Desde la Consola podrás: * **Ofrecer una plataforma con tu marca** a tus clientes (tu nombre y presentación, no “Callin”). * **Usar tu propio dominio** para que el cliente sienta que está dentro de tu ecosistema. * **Crear planes de suscripción** que tú vendes a tus clientes (por ejemplo, “Starter”, “Pro”, “Enterprise”). * **Cobrar a tus clientes con Stripe** (cuando esté conectado) para que la facturación siga tu flujo. * **Gestionar clientes y miembros del equipo** desde un solo lugar, sin depender de múltiples herramientas. ### Un ejemplo realista Imagina que tienes una agencia llamada **Northwind Voice Studio**. Quieres vender un producto de “recepcionista con IA” a clínicas locales. * Tu cliente ve la plataforma con la marca **Northwind Reception**. * Accede desde un dominio como **app.northwindreception.com**. * Tú le vendes un **plan mensual** que creaste en la Consola. * Los pagos se procesan con **Stripe**, y tú gestionas el acceso del cliente desde **Usuarios**. ## Visión general de lo configurable en la Consola A continuación tienes una vista de alto nivel de las áreas que normalmente usarás al operar con White Label. ### Configuración de White Label Aquí defines los básicos que verá el cliente en tu app con marca. * **Nombre de la app**: el nombre que se muestra en zonas como navegación y títulos de página. * **Dominio personalizado**: el dominio/subdominio desde el que tus clientes accederán (la configuración de DNS se hace desde la acción de **Configuración DNS**). * **Moneda**: se usa para precios y visualización de facturación. * **Idioma de la app**: idioma por defecto de la experiencia para tus clientes. * **Pestaña Apariencia**: permite ajustar la presentación visual (las opciones disponibles pueden variar según cuenta/plan). ### Integraciones Las integraciones conectan tu White Label con servicios de terceros esenciales. En la Consola puedes ver integraciones como: * **Stripe** (pagos) * **Twilio** (SMS y llamadas de voz; a veces marcado como obligatorio) * **SendGrid** (envío/automatización de emails) * **Intercom**, **Brevo Chat** (comunicación con clientes) * **Claves de API de Analítica y Seguimiento** (tracking y atribución) > **Consejo:** Si vas a cobrar a clientes, conecta Stripe pronto para poder probar el flujo completo. ### Usuarios Esta es tu zona de gestión de clientes y miembros del equipo. Desde aquí normalmente podrás: * Buscar y revisar usuarios * Crear usuarios * Gestionar acceso y estado ### Suscripciones Aquí es donde **ves y gestionas las suscripciones** de tus clientes.\ Te ayuda a entender quién está suscrito y en qué plan (según tu configuración e integraciones). ### Planes de suscripción Aquí creas y administras los planes que vendes. Elementos típicos que verás en un plan: * Nombre del plan * Periodicidad de cobro (por ejemplo, mensual) * Precio * Estado (activo/inactivo) ### Analítica UTM La Analítica UTM te ayuda a entender la **atribución de marketing**—por ejemplo, qué fuentes o campañas generaron registros. Normalmente podrás: * Filtrar por rango de fechas * Exportar resultados (por ejemplo, CSV) * Revisar desgloses como fuente y campaña (cuando haya datos) ## Orden recomendado de configuración (para no dejarte nada) Si es tu primera vez lanzando un White Label, este orden suele ser el más cómodo: 1. Define **Nombre de la app**, **Moneda** e **Idioma de la app** en **Configuración de White Label**. 2. Añade tu **Dominio personalizado** y completa la **Configuración DNS**. 3. Conecta las **Integraciones** críticas (especialmente Stripe si vas a cobrar a clientes). 4. Crea tus **Planes de suscripción**. 5. Añade/gestiona clientes y equipo en **Usuarios**. 6. Controla adopción y canales en **Analítica UTM**. # Prima di iniziare la configurazione del tuo White Label Source: https://support.callin.io/Automations/Whitelabel/WhiteLabel-copied-3 Capisci cosa significa White Label in Callin, dove si gestisce dalla Console e cosa puoi amministrare come agenzia prima di iniziare. ## Cosa significa “White Label” in Callin Il **White Label** in Callin è pensato per i team (soprattutto le **agenzie**) che vogliono **rivendere la tecnologia di Callin con il proprio brand**. Invece di mandare i clienti su “Callin”, puoi presentare l’esperienza come *il tuo prodotto*: il tuo nome, il tuo dominio, il tuo aspetto grafico e il tuo modello di fatturazione, mentre Callin gestisce l’infrastruttura dietro le quinte. > **Consiglio:** Pensa a “Callin dentro, il tuo brand fuori”. ## Dove si accede al White Label Tutte le opzioni White Label si gestiscono dalla **Console**. 1. Nell’app principale, clicca su **Console** in alto a destra. 2. Poi apri **Configurazione White Label**. Per andare, clicca qui: [Apri la configurazione White Label](https://app.callin.io/cms/white-label-configuration)Schermata: la pagina di configurazione White Label nella Console, dove imposti il nome dell’app, il dominio e altri valori predefiniti visibili ai clienti.
> **Importante:** Alcune opzioni possono variare in base al tuo piano e ai permessi. ## Cosa puoi fare come agenzia con il White Label Il White Label è progettato per aiutarti a lavorare come una vera azienda prodotto, anche se sei un’agenzia. Con la Console puoi: * **Offrire una piattaforma con il tuo brand** ai clienti (il tuo nome e la tua presentazione, non “Callin”). * **Usare il tuo dominio** per far percepire ai clienti che sono nel tuo ecosistema. * **Creare piani di abbonamento** da vendere ai clienti (ad esempio “Starter”, “Pro”, “Enterprise”). * **Incassare con Stripe** (quando collegato) così la fatturazione segue il tuo flusso. * **Gestire clienti e team** in un unico posto, senza dover usare più strumenti. ### Un esempio realistico Immagina di gestire un’agenzia chiamata **Northwind Voice Studio**. Vuoi vendere un prodotto “receptionist con IA” a cliniche locali. * Il cliente vede la piattaforma brandizzata come **Northwind Reception**. * Accede tramite un dominio come **app.northwindreception.com**. * Tu gli vendi un **piano mensile** creato nella Console. * I pagamenti passano da **Stripe** e tu gestisci l’accesso del cliente da **Utenti**. ## Panoramica rapida di ciò che è configurabile nella Console Qui sotto trovi una panoramica di alto livello delle aree che userai più spesso per gestire il White Label. ### Configurazione White Label Qui definisci le basi che il cliente vedrà nella tua app brandizzata. * **Nome dell’app**: il nome mostrato nella navigazione e nei titoli delle pagine. * **Dominio personalizzato**: il dominio/sottodominio che useranno i clienti (la configurazione DNS si gestisce dall’azione **Configurazione DNS**). * **Valuta**: usata per prezzi e visualizzazione della fatturazione. * **Lingua dell’app**: la lingua predefinita dell’esperienza cliente. * **Scheda Aspetto**: consente di regolare la presentazione visiva (le opzioni disponibili possono variare in base ad account/piano). ### Integrazioni Le integrazioni collegano il tuo White Label ai servizi di terze parti fondamentali. Nella Console puoi vedere integrazioni come: * **Stripe** (pagamenti) * **Twilio** (SMS e chiamate vocali; talvolta indicato come obbligatorio) * **SendGrid** (invio/automazione email) * **Intercom**, **Brevo Chat** (comunicazione con i clienti) * **Chiavi API di analisi e tracciamento** (tracciamento e attribuzione) > **Consiglio:** Se la fatturazione è parte del tuo modello, collega Stripe subito così puoi testare l’intero percorso cliente. ### Utenti Questa è l’area di gestione di clienti e membri del team. Da qui di solito puoi: * Cercare e consultare utenti * Creare utenti * Gestire accesso e stato ### Abbonamenti Qui puoi **visualizzare e gestire gli abbonamenti** dei clienti.\ Ti aiuta a capire chi è abbonato e a quale piano (in base a configurazione e integrazioni). ### Piani di abbonamento Qui crei e gestisci i piani che vendi. Elementi tipici che vedrai in un piano: * Nome del piano * Cadenza di fatturazione (ad esempio mensile) * Prezzo * Stato (attivo/inattivo) ### Analitica UTM L’analitica UTM ti aiuta a capire **l’attribuzione marketing** — ad esempio quali sorgenti o campagne hanno portato iscrizioni. Di solito puoi: * Filtrare per intervallo di date * Esportare i risultati (ad esempio in CSV) * Vedere breakdown come sorgente e campagna (quando sono presenti dati) ## Ordine consigliato di configurazione (per non dimenticare nulla) Alla prima attivazione di un White Label, questo ordine rende tutto più semplice: 1. Imposta **Nome dell’app**, **Valuta** e **Lingua dell’app** in **Configurazione White Label**. 2. Aggiungi il tuo **Dominio personalizzato** e completa la **Configurazione DNS**. 3. Collega le **Integrazioni** critiche (soprattutto Stripe se vuoi fatturare i clienti). 4. Crea i **Piani di abbonamento**. 5. Aggiungi/gestisci clienti e team in **Utenti**. 6. Monitora acquisizione e canali in **Analitica UTM**. # Telephony Source: https://support.callin.io/Automations/Whitelabel/telefhony How the Telephony section in the White Label Console works: buy managed phone numbers, organize your inventory, assign numbers to your clients' subaccounts, and understand how call billing works. The **Telephony** section is where you, as a White Label admin, get phone numbers for the agents running on your platform. You buy them once into your own inventory, and from there you assign each number to the subaccount of the client that needs it. Everything in this section is organized into three tabs: * **Inventory** — the numbers you already own. * **Marketplace** — the catalog where you buy new numbers. * **Billing** — the rules that apply to call billing. Across the three tabs you'll see four summary cards at the top. They give you a quick read of what this section is for: * **Global number coverage** — you can browse phone numbers from many countries from a single place. Useful when your clients operate in different regions. * **Buy inside the platform** — numbers are purchased directly through Callin's managed Telnyx infrastructure. You don't need a Telnyx account of your own. * **Assign to subaccounts** — once a number is in your inventory, you can link it to the subaccount of any client in your environment. * **First-minute rounding** — call billing is enforced with a one-minute minimum. The Billing tab explains it in detail. > **Tip:** Open the tabs in order the first time. Marketplace to understand what's available, Inventory to see where new numbers will land, Billing to know exactly what you'll be charged for. ## Inventory The **Inventory** tab is your personal warehouse of phone numbers. Every number you've already bought lives here, ready to be assigned to a client's subaccount.Screenshot: the Inventory tab. The counters at the top tell you how many numbers you own and how many are already assigned.
The first time you open Telephony, your inventory will be empty. That's normal — you'll see a **No numbers found** message until you make your first purchase. ### Counters Two counters sit at the top of the tab and give you the state of your inventory at a glance: * **Total inventory** — the total number of phone numbers you own. * **Assigned numbers** — how many of those are already linked to a client's subaccount. The difference between the two tells you how many numbers are still free and ready to assign. ### Filters and actions The filter bar lets you find a specific number when your inventory grows: * **Search by number or label** — find a number by digits or by the label you gave it. * **All countries** — narrow the list to a single country. * **All types** — narrow the list to a single number type (we explain types in the next tab). * **Refresh** — reloads the list. Useful right after a purchase if the new number hasn't appeared yet. * **Buy number** — a shortcut that takes you to the **Marketplace** tab. > **Tip:** Give each number a clear label as soon as you buy it — for example, the client's company name. When your inventory grows, labels are what keep things readable. ### Assigning a number to a subaccount Once a number is in your inventory, you can assign it to any subaccount in your environment. The number stays in your inventory; the assignment is what authorizes the client to use it inside their agents. Every time you assign a number, the **Assigned numbers** counter goes up by one, so you can always see how much of your inventory is in use. ## Marketplace The **Marketplace** tab is the catalog of numbers available for purchase. This is where you go whenever a client needs a new number you don't yet have in your inventory.Screenshot: the Marketplace tab. Each card represents an available number and shows everything you need to know before purchasing it.
### What each card shows Every number is shown as an independent card with all the information you need to decide: * **The number itself**, in international format. * **Country flag** and the city or region (for example, `TX, BELLVILLE`). * **Carrier** — the underlying provider that supplies the number (for example, Telnyx). * **Number type** — Local, Mobile, or Toll-free. Explained below. * **Capabilities** — `VOICE` and/or `SMS`, depending on what the number supports. * **Monthly cost** — the recurring fee charged every month while the number is active. * **Setup cost** — a one-time charge for activating the number. * **Purchase** — the button to buy it. ### Number types When you buy a phone number, you're not just choosing digits — you're choosing how callers perceive it and what it can do. You can filter the catalog by type: * **Local** — a number tied to a specific city or region (for example, US numbers attached to a state). Callers see a familiar area code, which helps with answer rates for local businesses. * **Mobile** — a number that lives on mobile networks. In some countries, mobile and local numbers behave differently, especially for SMS. * **Toll-free** — a number where the caller pays nothing; the cost falls on the line owner. Typical for national customer support lines. > **Tip:** Match the number type to what your client's customers will recognize. A local number for a neighborhood business; toll-free for a national support line. ### Searching and filtering The Marketplace has the same filter bar as Inventory: * **Search by number or label** — find specific digits. * **All countries** — browse by country. * **All types** — narrow to a single type. * **Refresh** — reloads the catalog. > **Common mistake:** Buying a number without checking its capabilities. A `VOICE`-only number can't send SMS, and an `SMS`-only number can't take calls. Always read the capability tags on the card before clicking **Purchase**. ### What happens after a purchase Once you click **Purchase** on a card and confirm: * The number is activated under your account. * It appears immediately in your **Inventory** tab. * The monthly cost starts counting from the activation date. * You can assign the number to any client subaccount whenever you're ready. ## Billing The **Billing** tab explains the rules that apply to every call made through the platform. There's nothing to configure here — the page is informational, but worth reading once so nothing on your invoice catches you by surprise.Screenshot: the Billing tab. The two blocks summarize how minutes are billed and how number provisioning is handled behind the scenes.
### First-minute rounding Whenever a call uses Callin's carrier and the numbers you bought through the platform, the **first minute is billed as a full minute**, even if the call lasts only a few seconds. After that first minute, billing continues normally based on real call duration. In practical terms: * It applies to the platform-side billing between you (the White Label admin) and Callin. * It applies to the resale billing you set up for your own end clients. * The rule is enforced automatically when call duration is calculated — you don't need to configure anything. > **Important:** Take this rule into account when you set your client-facing prices. If you charge per minute, your minimum chargeable unit should be one minute or higher. Otherwise short calls will cost you more than you're collecting. ### Managed provisioning This section confirms that you, as a White Label admin, **don't need to set up Telnyx by yourself**. Everything is handled by Callin's backend: * Numbers are provisioned through Callin's managed infrastructure. * Purchases happen directly inside the platform. * Purchased numbers can be assigned manually to any existing subaccount at any time. * Call handling and billing rules stay consistent across your whole environment. In short: you focus on selling phone numbers and capacity to your clients; the carrier-side complexity is invisible. > **Tip:** When a client asks about call quality, coverage, or how the system is wired, you can confidently answer that the platform runs on managed Telnyx infrastructure — there's nothing they need to integrate on their side. # Telefonía Source: https://support.callin.io/Automations/Whitelabel/telefonia Cómo funciona la sección de Telefonía dentro de la White Label Console: compra de números gestionados, organización del inventario, asignación de números a las subcuentas de tus clientes y reglas de facturación de llamadas. La sección de **Telefonía** es donde tú, como administrador del White Label, consigues los números de teléfono para los agentes que se ejecutan en tu plataforma. Compras los números una vez y se quedan en tu propio inventario; desde ahí asignas cada uno a la subcuenta del cliente que lo necesita. Todo lo que ves aquí está organizado en tres pestañas: * **Inventario** — los números que ya tienes en propiedad. * **Marketplace** — el catálogo desde el que compras números nuevos. * **Facturación** — las reglas que se aplican a la facturación de llamadas. En las tres pestañas verás cuatro tarjetas de resumen en la parte superior. Te dan una lectura rápida de para qué sirve esta sección: * **Cobertura global de números** — puedes navegar por números de muchos países desde un único sitio. Útil cuando tus clientes operan en regiones distintas. * **Compra dentro de la plataforma** — los números se compran directamente a través de la infraestructura gestionada de Callin sobre Telnyx. No necesitas tener tu propia cuenta de Telnyx. * **Asignación a subcuentas** — en cuanto un número está en tu inventario, puedes vincularlo a la subcuenta de cualquier cliente de tu entorno. * **Redondeo del primer minuto** — la facturación aplica un mínimo de un minuto por llamada. La pestaña **Facturación** lo explica en detalle. > **Consejo:** La primera vez, abre las pestañas en orden. **Marketplace** para ver qué hay disponible, **Inventario** para ver dónde aterrizarán los números que compres y **Facturación** para saber exactamente cómo te cobran. ## Inventario La pestaña **Inventario** es tu almacén personal de números de teléfono. Todo número que ya hayas comprado vive aquí, listo para asignarse a la subcuenta de un cliente.Captura: la pestaña Inventario. Los contadores de arriba te dicen cuántos números tienes y cuántos están ya asignados.
La primera vez que abras Telefonía, tu inventario estará vacío. Es lo normal — verás el mensaje **No se han encontrado números** hasta que hagas tu primera compra. ### Contadores Hay dos contadores en la parte de arriba que te dan el estado del inventario de un vistazo: * **Inventario total** — el número total de teléfonos que tienes en propiedad. * **Números asignados** — cuántos de esos ya están vinculados a la subcuenta de un cliente. La diferencia entre los dos te dice cuántos números siguen libres y listos para asignar. ### Filtros y acciones La barra de filtros te ayuda a encontrar un número concreto cuando el inventario crece: * **Buscar por número o etiqueta** — busca por dígitos o por la etiqueta que le pusiste al número. * **Todos los países** — limita la lista a un solo país. * **Todos los tipos** — limita la lista a un único tipo de número (los tipos se explican en la siguiente pestaña). * **Actualizar** — recarga la lista. Útil justo después de una compra si el número nuevo aún no ha aparecido. * **Comprar número** — un atajo que te lleva directamente a la pestaña **Marketplace**. > **Consejo:** Ponle una etiqueta clara a cada número en cuanto lo compres — por ejemplo, el nombre de la empresa del cliente. Cuando el inventario crezca, las etiquetas son lo que te ahorra tiempo. ### Asignar un número a una subcuenta Una vez el número está en tu inventario, puedes asignarlo a cualquier subcuenta de tu entorno. El número se queda en tu inventario; la asignación es lo que autoriza al cliente a usarlo dentro de sus agentes. Cada vez que asignas un número, el contador de **Números asignados** sube en uno, así que siempre tienes a la vista cuánto inventario está en uso. ## Marketplace La pestaña **Marketplace** es el catálogo de números disponibles para compra. Es donde vas cuando un cliente necesita un número nuevo que aún no tienes en tu inventario.Captura: la pestaña Marketplace. Cada tarjeta representa un número disponible y muestra todo lo que necesitas saber antes de comprarlo.
### Qué muestra cada tarjeta Cada número aparece como una tarjeta independiente con toda la información para decidir: * **El número en sí**, en formato internacional. * **Bandera del país** y la ciudad o región (por ejemplo, `TX, BELLVILLE`). * **Operador** — el proveedor que provee el número (por ejemplo, Telnyx). * **Tipo de número** — Local, Móvil o Gratuito (toll-free). Se explica más abajo. * **Capacidades** — `VOICE` y/o `SMS`, según lo que el número soporte. * **Coste mensual** — la cuota recurrente que se cobra cada mes mientras el número esté activo. * **Coste de alta** — un cargo único por activar el número. * **Comprar** — el botón para adquirirlo. ### Tipos de número Cuando compras un número, no eliges solo los dígitos — eliges cómo lo perciben quienes llaman y qué puede hacer. Puedes filtrar el catálogo por tipo: * **Local** — un número vinculado a una ciudad o región concretas (por ejemplo, números de Estados Unidos asociados a un estado). Quien llama ve un prefijo familiar, lo que ayuda a que descuelguen más en negocios locales. * **Móvil** — un número que vive en las redes móviles. En algunos países los móviles y los fijos se tratan distinto, sobre todo para SMS. * **Gratuito (toll-free)** — un número donde el que llama no paga nada; el coste recae en el dueño de la línea. Habitual para líneas nacionales de atención al cliente. > **Consejo:** Elige el tipo de número según lo que va a reconocer el cliente final de tu cliente. Un número local para un negocio de barrio; un toll-free para una línea de soporte de cobertura nacional. ### Búsqueda y filtros El Marketplace tiene la misma barra de filtros que el Inventario: * **Buscar por número o etiqueta** — busca dígitos concretos. * **Todos los países** — navega por país. * **Todos los tipos** — limita a un solo tipo. * **Actualizar** — recarga el catálogo. > **Error común:** Comprar un número sin mirar sus capacidades. Un número que solo es `VOICE` no puede mandar SMS, y al revés. Lee siempre las etiquetas de capacidades en la tarjeta antes de pulsar **Comprar**. ### Qué pasa tras la compra Una vez pulsas **Comprar** en una tarjeta y confirmas: * El número queda activado bajo tu cuenta. * Aparece inmediatamente en tu pestaña de **Inventario**. * El coste mensual empieza a contar desde la fecha de activación. * Puedes asignar el número a la subcuenta de cualquier cliente cuando lo decidas. ## Facturación La pestaña **Facturación** explica las reglas que se aplican a cada llamada que pasa por la plataforma. Aquí no hay nada que configurar — la página es informativa, pero merece la pena leerla una vez para que nada en tu factura te pille por sorpresa.Captura: la pestaña Facturación. Los dos bloques resumen cómo se facturan los minutos y cómo se gestiona el aprovisionamiento de números detrás de escena.
### Redondeo del primer minuto Cuando una llamada usa el operador de Callin y los números que has comprado a través de la plataforma, **el primer minuto se factura como un minuto completo**, aunque la llamada dure solo unos segundos. A partir de ese primer minuto, la facturación sigue normalmente según la duración real. En la práctica: * Se aplica a la facturación entre tú (administrador del White Label) y Callin. * Se aplica a la facturación de reventa que tú configures a tus clientes finales. * La regla se aplica automáticamente al calcular la duración de la llamada — no hay nada que configurar. > **Importante:** Ten esta regla en cuenta cuando montes tus precios para clientes. Si cobras por minuto, tu unidad mínima facturable también debe ser de al menos un minuto. Si no, las llamadas cortas te costarán más de lo que cobras. ### Aprovisionamiento gestionado Este bloque confirma que tú, como administrador del White Label, **no tienes que montar Telnyx por tu cuenta**. Todo lo gestiona el backend de Callin: * Los números se aprovisionan a través de la infraestructura gestionada por Callin. * Las compras pasan directamente dentro de la plataforma. * Los números comprados pueden asignarse manualmente a cualquier subcuenta existente cuando quieras. * Las reglas de gestión de llamadas y de facturación se mantienen consistentes en todo tu entorno. En resumen: tú te centras en venderles números y capacidad a tus clientes; la complejidad del operador queda fuera de la vista. > **Consejo:** Si un cliente te pregunta por calidad de llamada, cobertura o cómo está montado el sistema, puedes responder con tranquilidad que la plataforma corre sobre infraestructura gestionada de Telnyx — no hay nada que tengan que integrar por su lado. # Telefonia Source: https://support.callin.io/Automations/Whitelabel/telefonia-1 Come funziona la sezione Telefonia all'interno della White Label Console: acquisto di numeri gestiti, organizzazione dell'inventario, assegnazione dei numeri ai sottoconti dei tuoi clienti e regole di fatturazione delle chiamate. La sezione **Telefonia** è il posto in cui tu, come amministratore White Label, ottieni i numeri di telefono per gli agenti che girano sulla tua piattaforma. Li acquisti una volta nel tuo inventario, e da lì assegni ogni numero al sottoconto del cliente che ne ha bisogno. Tutto quello che vedi qui è organizzato in tre schede: * **Inventario** — i numeri che già possiedi. * **Marketplace** — il catalogo da cui acquisti nuovi numeri. * **Fatturazione** — le regole che si applicano alla fatturazione delle chiamate. In tutte e tre le schede vedrai quattro card di riepilogo nella parte superiore. Ti danno una lettura rapida di cosa serve questa sezione: * **Copertura globale dei numeri** — puoi sfogliare numeri di telefono di molti paesi da un unico posto. Utile quando i tuoi clienti operano in regioni diverse. * **Acquisto all'interno della piattaforma** — i numeri si acquistano direttamente attraverso l'infrastruttura Telnyx gestita da Callin. Non ti serve un account Telnyx tuo. * **Assegnazione ai sottoconti** — una volta che un numero è nel tuo inventario, puoi collegarlo al sottoconto di qualsiasi cliente del tuo ambiente. * **Arrotondamento del primo minuto** — la fatturazione delle chiamate applica un minimo di un minuto. La scheda **Fatturazione** lo spiega in dettaglio. > **Suggerimento:** Apri le schede in ordine la prima volta. **Marketplace** per capire cosa c'è disponibile, **Inventario** per vedere dove atterreranno i numeri che acquisti e **Fatturazione** per sapere esattamente come ti viene addebitato il servizio. ## Inventario La scheda **Inventario** è il tuo magazzino personale di numeri di telefono. Ogni numero che hai già acquistato vive qui, pronto per essere assegnato al sottoconto di un cliente.Schermata: la scheda Inventario. I contatori in alto ti dicono quanti numeri possiedi e quanti sono già assegnati.
La prima volta che apri Telefonia, il tuo inventario sarà vuoto. È normale — vedrai il messaggio **Nessun numero trovato** finché non fai il tuo primo acquisto. ### Contatori In cima alla scheda ci sono due contatori che ti danno lo stato dell'inventario a colpo d'occhio: * **Inventario totale** — il numero totale di telefoni che possiedi. * **Numeri assegnati** — quanti di quelli sono già collegati al sottoconto di un cliente. La differenza tra i due ti dice quanti numeri sono ancora liberi e pronti da assegnare. ### Filtri e azioni La barra dei filtri ti aiuta a trovare un numero specifico quando l'inventario cresce: * **Cerca per numero o etichetta** — cerca per cifre o per l'etichetta che hai dato al numero. * **Tutti i paesi** — limita l'elenco a un solo paese. * **Tutti i tipi** — limita l'elenco a un solo tipo di numero (i tipi sono spiegati nella scheda successiva). * **Aggiorna** — ricarica l'elenco. Utile subito dopo un acquisto, se il nuovo numero non è ancora comparso. * **Acquista numero** — una scorciatoia che ti porta direttamente alla scheda **Marketplace**. > **Suggerimento:** Metti un'etichetta chiara a ogni numero appena lo acquisti — per esempio, il nome dell'azienda del cliente. Quando l'inventario cresce, le etichette sono quello che ti fa risparmiare tempo. ### Assegnare un numero a un sottoconto Una volta che il numero è nel tuo inventario, puoi assegnarlo a qualsiasi sottoconto del tuo ambiente. Il numero resta nel tuo inventario; l'assegnazione è ciò che autorizza il cliente a usarlo all'interno dei suoi agenti. Ogni volta che assegni un numero, il contatore **Numeri assegnati** sale di uno, così hai sempre sott'occhio quanto inventario è in uso. ## Marketplace La scheda **Marketplace** è il catalogo dei numeri disponibili all'acquisto. È dove vai quando un cliente ha bisogno di un numero nuovo che non hai ancora nel tuo inventario.Schermata: la scheda Marketplace. Ogni card rappresenta un numero disponibile e mostra tutto quello che ti serve sapere prima di acquistarlo.
### Cosa mostra ogni card Ogni numero compare come una card indipendente con tutte le informazioni per decidere: * **Il numero stesso**, in formato internazionale. * **Bandiera del paese** e la città o regione (per esempio, `TX, BELLVILLE`). * **Operatore** — il provider che fornisce il numero (per esempio, Telnyx). * **Tipo di numero** — Locale, Mobile o Numero verde. Spiegati qui sotto. * **Capacità** — `VOICE` e/o `SMS`, a seconda di ciò che il numero supporta. * **Costo mensile** — il canone ricorrente addebitato ogni mese mentre il numero è attivo. * **Costo di attivazione** — un addebito una tantum per attivare il numero. * **Acquista** — il pulsante per comprarlo. ### Tipi di numero Quando acquisti un numero, non stai scegliendo solo le cifre — stai scegliendo come lo percepisce chi chiama e cosa può fare. Puoi filtrare il catalogo per tipo: * **Locale** — un numero legato a una città o regione specifica (per esempio, numeri statunitensi associati a uno stato). Chi chiama vede un prefisso familiare, e questo aiuta i tassi di risposta nelle attività locali. * **Mobile** — un numero che vive sulle reti mobili. In alcuni paesi i numeri mobili e quelli fissi vengono trattati in modo diverso, soprattutto per gli SMS. * **Numero verde (toll-free)** — un numero in cui chi chiama non paga nulla; il costo ricade sul titolare della linea. Tipico delle linee nazionali di assistenza clienti. > **Suggerimento:** Scegli il tipo di numero in base a ciò che riconoscerà il cliente finale del tuo cliente. Un numero locale per un'attività di quartiere; un numero verde per una linea di supporto a copertura nazionale. ### Ricerca e filtri Il Marketplace ha la stessa barra di filtri dell'Inventario: * **Cerca per numero o etichetta** — cerca cifre specifiche. * **Tutti i paesi** — sfoglia per paese. * **Tutti i tipi** — limita a un solo tipo. * **Aggiorna** — ricarica il catalogo. > **Errore comune:** Acquistare un numero senza controllare le sue capacità. Un numero solo `VOICE` non può inviare SMS, e un numero solo `SMS` non può ricevere chiamate. Leggi sempre le etichette delle capacità sulla card prima di cliccare **Acquista**. ### Cosa succede dopo l'acquisto Una volta che clicchi **Acquista** su una card e confermi: * Il numero viene attivato sul tuo account. * Compare immediatamente nella tua scheda **Inventario**. * Il costo mensile inizia a contare dalla data di attivazione. * Puoi assegnare il numero al sottoconto di qualsiasi cliente quando vuoi. ## Fatturazione La scheda **Fatturazione** spiega le regole che si applicano a ogni chiamata effettuata attraverso la piattaforma. Qui non c'è niente da configurare — la pagina è informativa, ma vale la pena leggerla una volta per evitare sorprese in fattura.Schermata: la scheda Fatturazione. I due blocchi riassumono come vengono fatturati i minuti e come viene gestito il provisioning dei numeri dietro le quinte.
### Arrotondamento del primo minuto Ogni volta che una chiamata usa l'operatore di Callin e i numeri che hai acquistato attraverso la piattaforma, **il primo minuto viene fatturato come un minuto intero**, anche se la chiamata dura solo pochi secondi. Dopo quel primo minuto, la fatturazione prosegue normalmente in base alla durata reale. In pratica: * Si applica alla fatturazione lato piattaforma tra te (l'amministratore White Label) e Callin. * Si applica alla fatturazione di rivendita che imposti per i tuoi clienti finali. * La regola viene applicata in automatico al calcolo della durata della chiamata — non devi configurare niente. > **Importante:** Tieni conto di questa regola quando imposti i prezzi per i tuoi clienti. Se fatturi al minuto, anche la tua unità minima addebitabile deve essere di almeno un minuto. Altrimenti le chiamate brevi ti costeranno più di quanto incassi. ### Provisioning gestito Questo blocco conferma che tu, come amministratore White Label, **non devi configurare Telnyx da solo**. Tutto viene gestito dal backend di Callin: * I numeri vengono provisionati attraverso l'infrastruttura gestita di Callin. * Gli acquisti avvengono direttamente all'interno della piattaforma. * I numeri acquistati possono essere assegnati manualmente a qualsiasi sottoconto esistente in qualsiasi momento. * Le regole di gestione delle chiamate e di fatturazione restano coerenti in tutto il tuo ambiente. In sintesi: tu ti concentri sul vendere numeri e capacità ai tuoi clienti; la complessità lato operatore resta invisibile. > **Suggerimento:** Se un cliente ti chiede della qualità delle chiamate, della copertura o di come è strutturato il sistema, puoi rispondere con tranquillità che la piattaforma gira su infrastruttura Telnyx gestita — non c'è niente che debbano integrare dalla loro parte. # UTM Analytics Source: https://support.callin.io/Automations/Whitelabel/utm See where signups come from by tracking UTM marketing data captured at signup and free-trial start. ## What this section is for **UTM Analytics** helps you understand which marketing links are bringing users into your white-label workspace. It shows UTM attribution that’s captured when a user **signs up** and when they **start a free trial**. This is useful when you want to answer questions like: * “Which campaign is actually bringing signups?” * “Are users coming from ads, partners, or organic sources?” * “Which landing page converts best?” [Click here to open UTM Analytics](https://app.callin.io/cms/utm)Screenshot: UTM Analytics dashboard with summary metrics, breakdown panels, filters, and an export option for the full list.
> **Tip:** If you see 0 records or “no UTM data,” it usually means users signed up without UTM parameters in the link, or the campaign hasn’t generated signups yet. ## How to read the dashboard At the top you’ll typically see summary metrics such as: * **Total**: total users/signups in the current view * **With UTM**: how many have UTM attribution captured * **Coverage**: the percentage of users in the view that include UTM data On the right, you may also have quick actions like: * **Refresh**: reload the latest data * **Export CSV**: download the list for reporting > **Important:** Labels and available fields can vary depending on your account, plan, and UI language. ## How to search and filter ### Search Use the search bar to find a specific user (for example, by email or name). ### Date range Use the **From** and **To** date selectors to focus on a period (for example, “last 7 days” or “this month”). ### Filters Use **Filters** to narrow the results further (for example, by source or campaign—available options can vary). ### Clear Use **Clear** to reset filters and return to the default view. ## What UTM fields mean (in plain language) UTM parameters are labels added to a link so you can tell where traffic came from. Common fields you’ll see: | Field | What it means | Example | | ----------- | --------------------------- | ---------------------------------- | | Source | The platform or origin | `google`, `facebook`, `newsletter` | | Campaign | The campaign name | `summer_promo`, `launch_2026` | | Landing URL | The page the user landed on | `/pricing`, `/signup`, `/promo` | > **Common mistake:** Using inconsistent names (e.g., `Facebook`, `facebook`, `fb`). Pick one style and stick to it so reports are clean. ## Practical examples ### Example 1: Tracking a paid ad If you’re running an ad, you might share a link like: * Source: `facebook` * Campaign: `starter_offer` Then, when users sign up via that link, you can quickly confirm the campaign is generating signups. ### Example 2: Comparing landing pages Send two versions of a landing page with different campaign names: * Campaign A: `pricing_page_test` * Campaign B: `homepage_test` After a week, use the date filter and compare results to see which landing page brought more signups (and with higher UTM coverage). ## When a user asks “Where did this signup come from?” A simple checklist: 1. Search the user in **UTM Analytics** 2. Check the user’s **Source** and **Campaign** 3. If it’s blank, confirm they used the correct link (with UTM parameters) > **Tip:** For consistent reporting, create a “link naming rule” for your team (for example: source in lowercase, campaigns with underscores, no spaces). # Analítica UTM Source: https://support.callin.io/Automations/Whitelabel/utm-copied-1 Descubre de dónde vienen tus registros con datos UTM capturados durante el registro y al iniciar la prueba gratuita. ## Para qué sirve esta sección **Analítica UTM** te ayuda a entender qué enlaces y campañas de marketing están trayendo usuarios a tu entorno de marca blanca. Aquí se muestra la atribución UTM que se captura cuando un usuario **se registra** y cuando **inicia una prueba gratuita**. Sirve para responder preguntas como: * “¿Qué campaña está generando registros de verdad?” * “¿Los usuarios vienen de anuncios, partners o fuentes orgánicas?” * “¿Qué página de aterrizaje convierte mejor?” [Haz clic aquí para abrir Analítica UTM](https://app.callin.io/cms/utm)Captura: panel de datos UTM con métricas de resumen, desglose por fuente/campaña, filtros y listado de usuarios.
> **Consejo:** Si ves 0 registros o “sin datos UTM”, normalmente significa que los usuarios se registraron sin parámetros UTM en el enlace, o que la campaña todavía no ha generado registros. > **Importante:** Los textos exactos y las opciones disponibles pueden variar según tu cuenta, tu plan y el idioma configurado. ## Cómo leer el panel En la parte superior suelen aparecer métricas de resumen como: * **Total**: total de usuarios/registros en la vista actual. * **Con UTM**: cuántos registros tienen atribución UTM. * **Cobertura**: porcentaje de registros con UTM dentro del total. También es habitual ver acciones rápidas como: * **Actualizar**: recargar los datos más recientes. * **Exportar CSV**: descargar el listado para informes. ## Cómo buscar y filtrar ### Buscar usuarios Usa la barra de búsqueda para encontrar un usuario concreto (por ejemplo, por correo electrónico o nombre). ### Filtrar por fechas Utiliza los selectores **Desde** y **Hasta** para centrarte en un periodo (por ejemplo, “últimos 7 días” o “este mes”). ### Aplicar filtros Usa **Filtros** para acotar por criterios como fuente o campaña (las opciones pueden variar según tu cuenta). ### Limpiar filtros Usa **Limpiar** para volver a la vista por defecto. ## Qué significan los campos UTM (en sencillo) Los parámetros UTM son etiquetas que se añaden a un enlace para saber de dónde viene el tráfico. Campos habituales: * **Fuente**: la plataforma u origen (por ejemplo, `google`, `facebook`, `newsletter`). * **Campaña**: el nombre de la campaña (por ejemplo, `promo_verano`, `lanzamiento_2026`). * **URL de aterrizaje**: la página donde aterriza el usuario (por ejemplo, `/precios`, `/registro`, `/promo`). > **Error común:** Usar nombres inconsistentes (por ejemplo, `Facebook`, `facebook`, `fb`). Elige un estándar y mantenlo para que los reportes sean claros. ## Ejemplos prácticos ### Ejemplo 1: Medir un anuncio de pago Si lanzas un anuncio, puedes usar un enlace etiquetado con: * Fuente: `facebook` * Campaña: `oferta_starter` Luego, en **Analítica UTM**, confirmas rápidamente si esa campaña está generando registros. ### Ejemplo 2: Comparar dos páginas de aterrizaje Crea dos enlaces con campañas distintas: * Campaña A: `test_precios` * Campaña B: `test_inicio` Tras una semana, filtra por fechas y compara resultados para ver qué página trae más registros (y con mejor cobertura UTM). ## Cuando un cliente pregunta “¿de dónde salió este registro?” Checklist rápido: 1. Busca al usuario en **Analítica UTM**. 2. Revisa **Fuente** y **Campaña**. 3. Si está vacío, confirma que se usó el enlace correcto con parámetros UTM. > **Consejo:** Define una regla interna para nombrar enlaces (por ejemplo: fuente en minúsculas y campañas con guiones bajos, sin espacios). # Analyse UTM Source: https://support.callin.io/Automations/Whitelabel/utm-copied-2 Identifiez l’origine de vos inscriptions grâce aux données UTM capturées lors de l’inscription et au démarrage de l’essai gratuit. ## À quoi sert cette section **Analyse UTM** vous aide à comprendre quels liens et campagnes marketing amènent des utilisateurs dans votre environnement en marque blanche. Elle affiche l’attribution UTM capturée quand un utilisateur **s’inscrit** et quand il **démarre un essai gratuit**. Utile pour répondre à des questions comme : * « Quelle campagne génère réellement des inscriptions ? » * « Les utilisateurs viennent-ils d’annonces, de partenaires ou de sources organiques ? » * « Quelle page d’atterrissage convertit le mieux ? » [Cliquez ici pour ouvrir Analyse UTM](https://app.callin.io/cms/utm)Capture : tableau de bord des données UTM avec indicateurs, répartition par source/campagne, filtres et liste d’utilisateurs.
> **Astuce :** Si vous voyez 0 enregistrement ou « aucune donnée UTM », cela signifie généralement que les utilisateurs se sont inscrits sans paramètres UTM dans le lien, ou que la campagne n’a pas encore généré d’inscriptions. > **Important :** Les libellés exacts et les options disponibles peuvent varier selon votre compte, votre formule et la langue configurée. ## Comment lire le tableau de bord En haut, vous verrez souvent des indicateurs de synthèse comme : * **Total** : nombre total d’utilisateurs/inscriptions dans la vue actuelle. * **Avec UTM** : combien d’inscriptions ont une attribution UTM. * **Couverture** : pourcentage d’inscriptions avec UTM sur le total. Vous pouvez aussi voir des actions rapides comme : * **Actualiser** : recharger les données les plus récentes. * **Exporter en CSV** : télécharger la liste pour vos rapports. ## Rechercher et filtrer ### Rechercher des utilisateurs Utilisez la barre de recherche pour retrouver un utilisateur (par exemple par e-mail ou par nom). ### Filtrer par période Utilisez les sélecteurs **Du** et **Au** pour vous concentrer sur une période (par exemple « 7 derniers jours » ou « ce mois-ci »). ### Appliquer des filtres Utilisez **Filtres** pour affiner par source ou campagne (les options peuvent varier selon votre compte). ### Réinitialiser Utilisez **Effacer** pour revenir à la vue par défaut. ## Signification des champs UTM (simplement) Les paramètres UTM sont des étiquettes ajoutées à un lien pour identifier l’origine du trafic. Champs courants : * **Source** : la plateforme d’origine (ex. `google`, `facebook`, `newsletter`). * **Campagne** : le nom de la campagne (ex. `promo_ete`, `lancement_2026`). * **URL d’atterrissage** : la page sur laquelle l’utilisateur arrive (ex. `/tarifs`, `/inscription`, `/promo`). > **Erreur fréquente :** Utiliser des noms incohérents (ex. `Facebook`, `facebook`, `fb`). Définissez une convention et tenez-vous-y pour des rapports propres. ## Exemples pratiques ### Exemple 1 : Mesurer une annonce payante Pour une annonce, vous pouvez utiliser un lien étiqueté : * Source : `facebook` * Campagne : `offre_starter` Ensuite, dans **Analyse UTM**, vous vérifiez rapidement si la campagne génère des inscriptions. ### Exemple 2 : Comparer deux pages d’atterrissage Créez deux liens avec des campagnes différentes : * Campagne A : `test_tarifs` * Campagne B : `test_accueil` Après une semaine, filtrez par date et comparez les résultats pour voir quelle page apporte le plus d’inscriptions (et avec une meilleure couverture UTM). ## Quand un client demande « d’où vient cette inscription ? » Checklist rapide : 1. Recherchez l’utilisateur dans **Analyse UTM**. 2. Vérifiez **Source** et **Campagne**. 3. Si c’est vide, confirmez que le bon lien (avec paramètres UTM) a été utilisé. > **Astuce :** Définissez une règle de nommage interne (par exemple : sources en minuscules, campagnes avec des tirets bas, sans espaces). # Analisi UTM Source: https://support.callin.io/Automations/Whitelabel/utm-copied-3 Scopri da dove arrivano le registrazioni grazie ai dati UTM acquisiti durante la registrazione e all’avvio della prova gratuita. ## A cosa serve questa sezione **Analisi UTM** ti aiuta a capire quali link e campagne di marketing portano utenti nel tuo ambiente in white label. Qui trovi l’attribuzione UTM acquisita quando un utente **si registra** e quando **avvia una prova gratuita**. È utile per rispondere a domande come: * “Quale campagna sta generando davvero registrazioni?” * “Gli utenti arrivano da annunci, partner o fonti organiche?” * “Quale pagina di atterraggio converte meglio?” [Fai clic qui per aprire Analisi UTM](https://app.callin.io/cms/utm)Schermata: dashboard dei dati UTM con metriche, suddivisione per sorgente/campagna, filtri e lista utenti.
> **Consiglio:** Se vedi 0 record o “nessun dato UTM”, di solito significa che gli utenti si sono registrati senza parametri UTM nel link, oppure che la campagna non ha ancora generato registrazioni. > **Importante:** Le diciture esatte e le opzioni disponibili possono variare in base al tuo account, al tuo piano e alla lingua configurata. ## Come leggere la dashboard In alto compaiono spesso metriche riepilogative come: * **Totale**: numero totale di utenti/registrazioni nella vista corrente. * **Con UTM**: quante registrazioni hanno attribuzione UTM. * **Copertura**: percentuale di registrazioni con UTM sul totale. Potresti anche trovare azioni rapide come: * **Aggiorna**: ricarica i dati più recenti. * **Esporta CSV**: scarica l’elenco per i report. ## Come cercare e filtrare ### Cercare utenti Usa la barra di ricerca per trovare un utente specifico (per esempio tramite e-mail o nome). ### Filtrare per intervallo di date Usa i selettori **Da** e **A** per concentrarti su un periodo (per esempio “ultimi 7 giorni” o “questo mese”). ### Applicare filtri Usa **Filtri** per restringere per sorgente o campagna (le opzioni possono variare in base al tuo account). ### Ripristinare Usa **Cancella** per tornare alla vista predefinita. ## Significato dei campi UTM (in modo semplice) I parametri UTM sono etichette aggiunte a un link per capire da dove proviene il traffico. Campi più comuni: * **Sorgente**: la piattaforma di origine (es. `google`, `facebook`, `newsletter`). * **Campagna**: il nome della campagna (es. `promo_estate`, `lancio_2026`). * **URL di atterraggio**: la pagina su cui arriva l’utente (es. `/prezzi`, `/registrazione`, `/promo`). > **Errore comune:** Usare nomi non coerenti (es. `Facebook`, `facebook`, `fb`). Scegli una convenzione e rispettala per avere report puliti. ## Esempi pratici ### Esempio 1: Misurare un annuncio a pagamento Per un annuncio puoi usare un link etichettato: * Sorgente: `facebook` * Campagna: `offerta_starter` Poi, in **Analisi UTM**, controlli subito se la campagna sta portando registrazioni. ### Esempio 2: Confrontare due pagine di atterraggio Crea due link con campagne diverse: * Campagna A: `test_prezzi` * Campagna B: `test_home` Dopo una settimana, filtra per data e confronta i risultati per capire quale pagina porta più registrazioni (e con migliore copertura UTM). ## Quando un cliente chiede “da dove arriva questa registrazione?” Checklist rapida: 1. Cerca l’utente in **Analisi UTM**. 2. Controlla **Sorgente** e **Campagna**. 3. Se è vuoto, verifica che sia stato usato il link corretto con parametri UTM. > **Consiglio:** Definisci una regola interna di denominazione (per esempio: sorgenti in minuscolo e campagne con trattini bassi, senza spazi). # UTM-Analyse Source: https://support.callin.io/Automations/Whitelabel/utm-copied-4 Erkennen Sie, woher Registrierungen kommen, anhand von UTM-Daten, die bei der Registrierung und beim Start der kostenlosen Testphase erfasst werden. ## Wofür dieser Bereich gedacht ist **UTM-Analyse** hilft Ihnen zu verstehen, welche Marketing-Links und Kampagnen Nutzer in Ihre White-Label-Umgebung bringen. Hier sehen Sie die UTM-Zuordnung, die erfasst wird, wenn sich ein Nutzer **registriert** und wenn er **eine kostenlose Testphase startet**. Das ist hilfreich für Fragen wie: * „Welche Kampagne bringt tatsächlich Registrierungen?“ * „Kommen Nutzer über Anzeigen, Partner oder organische Quellen?“ * „Welche Landingpage konvertiert am besten?“ [Klicken Sie hier, um die UTM-Analyse zu öffnen](https://app.callin.io/cms/utm)Screenshot: UTM-Dashboard mit Kennzahlen, Aufteilung nach Quelle/Kampagne, Filtern und einer Nutzerliste.
> **Tipp:** Wenn Sie 0 Einträge oder „keine UTM-Daten“ sehen, wurden Registrierungen meist ohne UTM-Parameter im Link durchgeführt oder die Kampagne hat noch keine Registrierungen erzeugt. > **Wichtig:** Die genauen Bezeichnungen und verfügbaren Optionen können je nach Konto, Tarif und UI-Sprache variieren. ## So lesen Sie das Dashboard Oben sehen Sie häufig Übersichtskennzahlen wie: * **Gesamt**: Gesamtzahl der Nutzer/Registrierungen in der aktuellen Ansicht. * **Mit UTM**: wie viele Registrierungen UTM-Zuordnung enthalten. * **Abdeckung**: Anteil der Registrierungen mit UTM im Verhältnis zum Gesamtwert. Zusätzlich sind oft Schnellaktionen vorhanden wie: * **Aktualisieren**: lädt die neuesten Daten neu. * **Als CSV exportieren**: lädt die Liste für Auswertungen herunter. ## Suchen und filtern ### Nutzer suchen Verwenden Sie die Suchleiste, um einen bestimmten Nutzer zu finden (zum Beispiel per E-Mail oder Name). ### Zeitraum filtern Nutzen Sie die Datumsfelder **Von** und **Bis**, um einen Zeitraum auszuwählen (zum Beispiel „letzte 7 Tage“ oder „dieser Monat“). ### Filter anwenden Verwenden Sie **Filter**, um nach Quelle oder Kampagne einzuschränken (Optionen können je nach Konto variieren). ### Zurücksetzen Verwenden Sie **Zurücksetzen**, um zur Standardansicht zurückzukehren. ## Bedeutung der UTM-Felder (einfach erklärt) UTM-Parameter sind Etiketten, die an einen Link angehängt werden, um die Herkunft des Traffics zu erkennen. Häufige Felder: * **Quelle**: die Herkunftsplattform (z. B. `google`, `facebook`, `newsletter`). * **Kampagne**: der Kampagnenname (z. B. `sommer_promo`, `launch_2026`). * **Landing-URL**: die Seite, auf der der Nutzer landet (z. B. `/preise`, `/registrierung`, `/promo`). > **Häufiger Fehler:** Uneinheitliche Namen (z. B. `Facebook`, `facebook`, `fb`). Legen Sie eine Konvention fest und bleiben Sie dabei, damit Berichte sauber sind. ## Praxisbeispiele ### Beispiel 1: Eine bezahlte Anzeige messen Für eine Anzeige können Sie einen Link mit folgenden Angaben verwenden: * Quelle: `facebook` * Kampagne: `starter_angebot` Danach prüfen Sie in der **UTM-Analyse**, ob die Kampagne Registrierungen erzeugt. ### Beispiel 2: Zwei Landingpages vergleichen Erstellen Sie zwei Links mit unterschiedlichen Kampagnennamen: * Kampagne A: `test_preise` * Kampagne B: `test_startseite` Nach einer Woche filtern Sie nach Datum und vergleichen die Ergebnisse, um zu sehen, welche Seite mehr Registrierungen bringt (und mit besserer UTM-Abdeckung). ## Wenn ein Kunde fragt „Woher kommt diese Registrierung?“ Schnell-Checkliste: 1. Suchen Sie den Nutzer in der **UTM-Analyse**. 2. Prüfen Sie **Quelle** und **Kampagne**. 3. Wenn es leer ist, stellen Sie sicher, dass der richtige Link mit UTM-Parametern verwendet wurde. > **Tipp:** Definieren Sie eine interne Benennungsregel (zum Beispiel: Quellen klein schreiben, Kampagnen mit Unterstrichen, keine Leerzeichen). # Billing and Platform Fees Source: https://support.callin.io/Billing How Callin charges you per minute, how you set your own selling price on top, and how each payment from your end users is split. You buy minutes from Callin at a fixed rate and resell them to your end users at whatever price you choose. The difference between the two is your margin. This page explains what Callin charges you, how to price your plans so the margin works, and what happens to the money when one of your users pays. ## The model in one sentence Callin charges you **\$0.16 per minute** for the minutes included in the plans you sell. You decide what to charge your end users for those same minutes. When your user pays, the platform fee is deducted automatically and the rest is yours. There's no monthly bill from Callin to reconcile and no invoice to approve. The split happens inside the payment itself. ## Your cost: \$0.16 per minute This is the number to build everything else on. It's the default rate across the platform, and it applies to your main white label account and to every sub-account you create. The cost of a plan is straightforward to work out: **Minutes included in the plan × \$0.16 = what the plan costs you** | Plan size | Your cost | | ------------- | --------- | | 500 minutes | \$80 | | 1,000 minutes | \$160 | | 1,500 minutes | \$240 | Some accounts have a lower rate through a custom agreement, negotiated case by case. If you're not sure which rate applies to yours, your account manager can confirm it. Unless you've agreed otherwise, assume \$0.16. ## Your price: you decide When you create a plan, you set the price your end users will pay. **This price has to be higher than \$0.16 per minute, or you have no margin.** That's the whole business model. Callin sells you minutes at cost; you sell them at retail. Say you decide to charge \*\*$0.32 per minute** — double your cost. A plan of 1,000 minutes is then priced at $320, and the maths works out like this: | | Amount | | --------------------------------- | --------- | | Price you charge (1,000 × \$0.32) | \$320 | | Platform fee (1,000 × \$0.16) | −\$160 | | **Your gross margin** | **\$160** | Charge $0.30 and your margin is $140. Charge $0.25 and it's $90. Charge \$0.16 and you're working for free. > **Important:** Set the price of every plan above \$0.16 per minute. There's nothing in the platform stopping you from pricing at or below your cost, so the check is yours to make. ## Why usage doesn't change what you pay This is the point that causes the most confusion, so here it is plainly: **the platform fee is based on the minutes the plan includes, not the minutes your user actually spends.** Think about what you sold. Your end user pays \$320 for a plan of 1,000 minutes whether they make one call or a thousand. They're paying for capacity — the right to use those minutes — not for consumption. The platform fee works the same way, because it's charged against that same capacity. So the fee is identical in every scenario: | Minutes used in the cycle | Platform fee | Your margin | | ------------------------- | ------------ | ----------- | | 180 minutes | \$160 | \$160 | | 995 minutes | \$160 | \$160 | | 0 minutes | \$160 | \$160 | A quiet month doesn't reduce the fee, but it doesn't reduce your margin either. You already collected the full price from your user. Your position is the same in a quiet month as in a busy one, which is exactly what a fixed-price plan is designed to do. The practical takeaway when you're setting prices: your margin is decided the moment you publish the plan, not by how much your customers end up calling. ## How each payment is split Payments run through **Stripe Connect**, the payment system built into your white label platform. It's what makes it possible for your end user to pay you directly while the platform fee is routed to Callin in the same transaction. The moment your user's card is charged, the amount is divided into three parts: | Part | What it is | Who receives it | | ------------------ | --------------------------------------------- | --------------- | | **Amount** | The full price your end user paid | — | | **Platform fee** | Callin's charge for the minutes in the plan | Callin | | **Processing fee** | Stripe's charge for handling the card payment | Stripe | | **Net amount** | What remains after both fees | You | The processing fee is Stripe's own charge, typically a small percentage of the transaction plus a fixed amount per payment. It varies with the payment method, the card type and the country your user is paying from. Callin doesn't set it and it isn't part of your agreement with us — it's the standard cost of accepting card payments, and it's the one line that moves slightly from one payment to another. ## A complete example You sell a plan of \*\*1,000 minutes at $0.32 per minute** to Demo Dental Clinic. The plan is priced at $320 per month. | Line | Amount | | ----------------------------- | ------------ | | Amount your user paid | \$320.00 | | Platform fee (1,000 × \$0.16) | −\$160.00 | | Processing fee | −\$9.58 | | **Net amount for you** | **\$150.42** | Every month that subscription renews, you receive around $150. The $160 platform fee is fixed and predictable. The processing fee moves a little depending on how your customer pays, so treat that figure as an estimate rather than an exact number. If Demo Dental Clinic used 120 minutes that month, the table is unchanged. If they used 990, it's also unchanged. ## Pay as you go plans Alongside fixed plans, the platform offers a **Pay as you go (white-label)** option at **\$0.16 per minute** with no minutes included. It's billed daily, based on minutes actually consumed. The two models work on opposite principles: | | Fixed monthly plan | Pay as you go | | --------------------- | ------------------------------- | ------------------------- | | **Minutes included** | A set number, agreed in advance | None | | **What's charged** | The minutes in the plan | The minutes actually used | | **Billing frequency** | Once per monthly cycle | Daily | | **Predictable?** | Yes, same amount every cycle | No, follows usage | Because Pay as you go is charged at cost, it carries no margin for you. It's there for accessing the platform and for testing, not for reselling. To sell with a margin, create a fixed plan and price it above \$0.16 per minute. ## When a payment fails If your end user's card can't be charged, no split takes place, because no money was collected. You aren't charged a platform fee on a payment that never happened. The subscription moves to a **Past due** state and the user's available minutes drop to zero, so their agents stop taking calls until the situation is resolved. Once the payment goes through, the subscription returns to active, the minutes are restored, and the split runs normally on that payment. You can see the state of every subscription in **Subscriptions** on your white label panel, where each row shows the user, their plan, the price, the minutes remaining and the current status. It's worth checking periodically: a subscription sitting in past due is a customer whose service is interrupted, and usually the fastest fix is a direct conversation about updating their card. # Actions Source: https://support.callin.io/Create-AI-Agent/Actions Connect Callin to external platforms (calendar, CRM, automation, and webhooks) so your AI Agents can trigger real-world workflows. ## Actions Actions is the place where you connect Callin to other platforms so your AI Agents can **schedule**, **sync customer data**, **trigger automations**, and **send updates**—without doing everything manually. [Open Actions in the Console](https://app.callin.io/actions)Screenshot: The Actions hub where you can connect external platforms to Callin. Each card shows whether it’s connected and what button to use (Connect, View, Manage, etc.).
> **Tip:** If you’re not sure where to start, begin with **Calendar** (for booking) or **Automation** (for workflows like follow-ups and CRM updates). ## Where to find it 1. Open your Callin Console. 2. In the left menu, go to **Integrations → Actions**. ## How connecting works Each integration card shows a status and an action button: * **Not Connected** → You’ll usually see **Connect**. * **Connected** → You may see **View** and **Disconnect** (example: Google Calendar). * **Coming Soon** → The integration is listed but not available to connect yet (example: Slack). * Some platforms may use a different button label (example: **Manage** for Custom Integration, or **Go to n8n**). General flow: 1. Click the integration card’s button (**Connect / Manage / View**). 2. Follow the platform’s authorization or setup steps. 3. Return to Callin and confirm the card status updates. > **Important:** The exact authorization screens can vary depending on your account, plan, or how your organization manages permissions. > **Common mistake:** Connecting the wrong account (for example, the wrong Google account) and later wondering why events or data appear in the wrong place. ## Available integrations Below is what each available platform is typically used for and how you connect it from the Actions page. ### Google Calendar **What it’s for**Captura: El centro de Acciones donde puedes conectar plataformas externas con Callin. Cada tarjeta indica si está conectada y te permite iniciar la conexión o gestionar la integración.
> **Consejo:** Si no sabes por dónde empezar, comienza por un **calendario** (para reservas) o por una plataforma de **automatización** (para seguimientos y tareas repetitivas). ## Dónde encontrarlo 1. Abre tu consola de Callin. 2. En el menú izquierdo, entra en la sección de integraciones y abre **Acciones**. ## Cómo funciona la conexión Cada tarjeta de integración muestra un estado y un botón de acción: * **No conectado** → normalmente verás un botón para iniciar la conexión. * **Conectado** → puede aparecer una opción para ver detalles y otra para desconectar. * **Próximamente** → la integración aparece listada, pero aún no está disponible para conectarla (por ejemplo, Slack). * Algunas plataformas pueden usar botones con textos distintos según la integración (por ejemplo, un botón para ir a la plataforma o para administrar la configuración). Flujo general: 1. En la tarjeta de la integración, pulsa el botón para **conectar** o **administrar**. 2. Sigue los pasos de autorización o configuración que se muestren. 3. Vuelve a Callin y confirma que el estado de la tarjeta se actualiza. > **Importante:** Las pantallas exactas de autorización pueden variar según tu cuenta, tu plan o cómo tu organización gestiona permisos. > **Error común:** Conectar la cuenta equivocada (por ejemplo, otro correo) y luego no ver los eventos o datos donde esperabas. ## Integraciones disponibles A continuación se explica para qué se usa normalmente cada plataforma disponible y cómo conectarla desde la página de Acciones. ### Google Calendar **Para qué sirve**\ Usa Google Calendar para mantener las citas organizadas en un calendario que tu equipo ya utiliza. **Cómo conectarlo en Callin** * Si no está conectado, inicia la conexión desde la tarjeta de Google Calendar y completa la autorización. * Si ya está conectado, verás opciones para revisar la conexión y para desconectarla. **Ejemplos de uso con agentes de IA** * Un agente de agenda puede coordinar horarios y mantener las citas confirmadas reflejadas en tu calendario (por ejemplo: “Demo con Alex Rivera — martes 3:30 p. m.”). * Un agente puede ayudar a reducir ausencias usando el calendario como “fuente de verdad” de las próximas reuniones (por ejemplo, confirmando: “Estás reservado para el miércoles a las 10:00 a. m.”). ### Cal.com (Beta) **Para qué sirve**\ Cal.com es una plataforma de programación de citas. Conectarla puede ayudar a alinear Callin con tu configuración de agenda. **Cómo conectarlo en Callin** 1. Busca Cal.com y pulsa el botón para conectar. 2. Sigue los pasos que aparezcan durante la configuración (puede variar porque está marcado como beta). 3. Vuelve a Acciones y confirma que ya no aparece como no conectado. **Ejemplos de uso con agentes de IA** * Un agente de reservas puede guiar al cliente hacia el tipo de cita correcto (por ejemplo: “llamada introductoria de 15 minutos” frente a “onboarding de 30 minutos”). * Si tu equipo utiliza enlaces de agenda de Cal.com, un agente puede ayudar a dirigir a cada persona a la opción adecuada según su intención (ventas, soporte, onboarding). > **Importante:** Al estar en beta, el flujo de configuración y las opciones disponibles pueden cambiar. ### GoHighLevel **Para qué sirve**\ GoHighLevel es una plataforma de CRM. Conectarla ayuda a mantener alineada la información de clientes y leads entre Callin y tus flujos del CRM. **Cómo conectarlo en Callin** 1. En la tarjeta de GoHighLevel, inicia la conexión. 2. Completa los pasos de inicio de sesión y autorización. 3. Confirma que el estado de la integración se actualiza. **Ejemplos de uso con agentes de IA** * Después de una llamada, un agente puede ayudar a dejar listos los detalles del lead para tus seguimientos (por ejemplo: nombre, interés y notas del siguiente paso). * Un agente de ventas puede usar lo aprendido durante la conversación para mejorar el traspaso al equipo (por ejemplo: “Interesado en el plan Pro, quiere precios por correo”). ### Zoho **Para qué sirve**\ Zoho es otra opción de CRM. Úsalo si tu equipo gestiona leads, contactos o registros de clientes en Zoho. **Cómo conectarlo en Callin** 1. En la tarjeta de Zoho, inicia la conexión. 2. Sigue los pasos de autorización. 3. Confirma que el estado cambia a conectado. **Ejemplos de uso con agentes de IA** * Un agente de soporte puede ayudar a registrar el resultado de una llamada para que tu equipo haga seguimiento en el CRM. * Un agente puede apoyar la consistencia de datos pidiendo información faltante durante la conversación (por ejemplo: tamaño de empresa o método de contacto preferido). ### n8n **Para qué sirve**\ n8n es una plataforma de automatización. Es útil cuando quieres construir automatizaciones personalizadas que conecten varias herramientas. **Cómo conectarlo en Callin** * Desde la tarjeta de n8n, abre n8n y sigue las instrucciones para crear tu flujo y vincularlo con Callin (los pasos pueden variar según cómo esté alojado tu n8n). **Ejemplos de uso con agentes de IA** * Al terminar una llamada, activar un flujo que avise al equipo y cree una tarea de seguimiento. * Enrutar los resultados de una conversación por caminos distintos (por ejemplo: “demo reservada” → avisar a ventas; “necesita soporte” → crear un ticket). ### Zapier **Para qué sirve**\ Zapier te ayuda a conectar Callin con miles de apps y automatizar flujos sencillos sin desarrollo a medida. **Cómo conectarlo en Callin** 1. En la tarjeta de Zapier, inicia la conexión. 2. Completa los pasos de autorización. 3. Crea automatizaciones del tipo “si ocurre esto, entonces haz aquello” según tu necesidad. **Ejemplos de uso con agentes de IA** * Cuando un agente capta un nuevo lead, activar una secuencia de seguimiento por correo en tu herramienta de email. * Cuando se completa una llamada, enviar un resumen a una hoja de cálculo o a un gestor de tareas para tener visibilidad. ### Make.com **Para qué sirve**\ Make (antes Integromat) es otra plataforma para construir escenarios de varios pasos entre herramientas. **Cómo conectarlo en Callin** 1. En la tarjeta de Make.com, inicia la conexión. 2. Sigue los pasos que aparezcan durante la configuración. 3. Construye escenarios en Make para reflejar tu flujo. **Ejemplos de uso con agentes de IA** * Si un agente califica un lead como “alta intención”, activar un flujo de varios pasos (por ejemplo: avisar a un vendedor, crear una oportunidad y programar una tarea). * Enviar actualizaciones estructuradas a herramientas internas que tu equipo ya usa. ### Slack (Próximamente) **Para qué sirve**\ Slack se usa comúnmente para notificaciones del equipo y comunicación interna. **Disponibilidad**\ En la captura, Slack aparece como “próximamente”, lo que significa que se ve en Acciones pero aún no está disponible para conectarlo. **Ejemplos de uso con agentes de IA (cuando esté disponible)** * Notificar a un canal cuando un agente reserva una reunión (por ejemplo: “Nueva demo reservada: jueves 2:00 p. m.”). * Avisar a soporte cuando un cliente solicita ayuda durante una llamada. ### Integración personalizada **Para qué sirve**\ La integración personalizada está pensada para equipos que quieren conectar Callin con sus propios sistemas o servicios externos mediante webhooks. **Cómo conectarlo en Callin** * Abre la tarjeta de integración personalizada y entra en la pantalla de administración. * Configura allí los ajustes de webhook disponibles (los campos y opciones pueden variar según tu cuenta o plan). **Ejemplos de uso con agentes de IA** * Enviar el resultado de una llamada a tu panel interno (por ejemplo: “Lead calificado”, “Requiere seguimiento”, “No interesado”). * Activar un flujo en tu backend cada vez que un agente complete un tipo específico de interacción. > **Consejo:** La integración personalizada es una buena opción si ya tienes una herramienta interna y quieres que Callin envíe eventos hacia ella. ## Solución de problemas ### La integración sigue apareciendo como no conectada * Recarga la página y revisa de nuevo. * Prueba a desconectar y volver a conectar (si existe la opción). * Confirma que iniciaste sesión con la cuenta correcta en la plataforma. ### Conectaste la cuenta equivocada * Desconecta la integración (si está disponible) y vuelve a conectarla eligiendo la cuenta correcta durante la autorización. ### Los botones u opciones se ven distintos Algunas etiquetas y pasos pueden variar según tu plan, la configuración de tu organización o cambios del proveedor. # Actions Source: https://support.callin.io/Create-AI-Agent/Actions-copied-2 Connectez Callin à des plateformes externes (calendrier, CRM, automatisation et webhooks) pour que vos agents IA déclenchent des workflows concrets. ## Actions Actions est l’endroit où vous connectez Callin à d’autres plateformes afin que vos agents IA puissent **planifier**, **synchroniser des données clients**, **déclencher des automatisations** et **envoyer des mises à jour**—sans tout faire manuellement. [Ouvrir Actions dans la console](https://app.callin.io/actions)Capture : Le hub Actions où vous pouvez connecter des plateformes externes à Callin. Chaque carte indique si la connexion est active et vous permet de lancer la connexion ou de gérer l’intégration.
> **Conseil :** Si vous ne savez pas par où commencer, démarrez avec un **calendrier** (pour les rendez-vous) ou une plateforme d’**automatisation** (pour les relances et tâches répétitives). ## Où le trouver 1. Ouvrez votre console Callin. 2. Dans le menu de gauche, allez dans la section des intégrations puis ouvrez **Actions**. ## Comment fonctionne la connexion Chaque carte d’intégration affiche un état et un bouton d’action : * **Non connecté** → vous verrez généralement un bouton pour lancer la connexion. * **Connecté** → des options peuvent apparaître pour consulter les détails et pour déconnecter. * **Bientôt disponible** → l’intégration est listée, mais pas encore connectable (par exemple, Slack). * Certaines plateformes peuvent afficher des boutons au libellé différent selon l’intégration (par exemple, un bouton pour ouvrir la plateforme ou pour gérer la configuration). Flux général : 1. Sur la carte de l’intégration, cliquez sur le bouton pour **connecter** ou **gérer**. 2. Suivez les étapes d’autorisation ou de configuration affichées. 3. Revenez dans Callin et vérifiez que l’état de la carte s’est mis à jour. > **Important :** Les écrans d’autorisation exacts peuvent varier selon votre compte, votre offre ou la gestion des permissions dans votre organisation. > **Erreur fréquente :** Connecter le mauvais compte (par exemple, une autre adresse e-mail) puis ne pas retrouver les événements ou données au bon endroit. ## Intégrations disponibles Ci-dessous, l’usage habituel de chaque plateforme disponible et la façon de la connecter depuis la page Actions. ### Google Calendar **À quoi ça sert**\ Google Calendar permet de garder vos rendez-vous organisés dans un calendrier que votre équipe utilise déjà. **Comment le connecter dans Callin** * S’il n’est pas connecté, lancez la connexion depuis la carte Google Calendar puis terminez l’autorisation. * S’il est déjà connecté, des options permettent généralement de consulter la connexion et de la supprimer. **Exemples d’usage avec des agents IA** * Un agent de prise de rendez-vous peut coordonner des créneaux et s’assurer que les rendez-vous confirmés sont bien reflétés dans le calendrier (ex. : « Démo avec Alex Rivera — mardi 15 h 30 »). * Un agent peut aider à réduire les absences en s’appuyant sur le calendrier comme “source de vérité” des prochains rendez-vous (ex. : « Vous êtes bien prévu mercredi à 10 h 00 »). ### Cal.com (Bêta) **À quoi ça sert**\ Cal.com est une plateforme de planification de rendez-vous. La connexion peut aider à aligner Callin avec votre organisation de rendez-vous. **Comment le connecter dans Callin** 1. Trouvez Cal.com et utilisez le bouton de connexion. 2. Suivez les étapes affichées pendant la configuration (elles peuvent évoluer car la fonctionnalité est en bêta). 3. Revenez dans Actions et vérifiez que l’intégration n’apparaît plus comme non connectée. **Exemples d’usage avec des agents IA** * Un agent peut orienter un client vers le bon type de rendez-vous (ex. : « appel de découverte 15 minutes » vs « onboarding 30 minutes »). * Si votre équipe utilise des liens de planification Cal.com, un agent peut aider à diriger chaque personne vers l’option adaptée selon son besoin (vente, support, onboarding). > **Important :** Comme l’intégration est en bêta, le parcours de configuration et les options disponibles peuvent changer. ### GoHighLevel **À quoi ça sert**\ GoHighLevel est une plateforme CRM. La connexion aide à garder les informations de prospects et clients cohérentes avec vos workflows CRM. **Comment le connecter dans Callin** 1. Depuis la carte GoHighLevel, lancez la connexion. 2. Terminez la connexion au compte et l’autorisation. 3. Vérifiez que l’état de la carte passe à connecté. **Exemples d’usage avec des agents IA** * Après un appel, un agent peut aider à préparer les informations du prospect pour les relances (ex. : nom, intérêt et prochaines étapes). * Un agent commercial peut utiliser ce qu’il a appris pendant l’échange pour améliorer la transmission à l’équipe (ex. : « Intéressé par l’offre Pro, souhaite une proposition par e-mail »). ### Zoho **À quoi ça sert**\ Zoho est une autre option CRM. À utiliser si votre équipe gère prospects, contacts ou fiches clients dans Zoho. **Comment le connecter dans Callin** 1. Depuis la carte Zoho, lancez la connexion. 2. Suivez les étapes d’autorisation. 3. Vérifiez que l’état passe à connecté. **Exemples d’usage avec des agents IA** * Un agent de support peut aider à enregistrer le résultat d’un appel pour que l’équipe fasse un suivi dans le CRM. * Un agent peut améliorer la qualité des données en posant des questions pour compléter les informations manquantes (ex. : taille de l’entreprise, canal de contact préféré). ### n8n **À quoi ça sert**\ n8n est une plateforme d’automatisation. Elle est utile si vous voulez construire des automatisations personnalisées reliant plusieurs outils. **Comment le connecter dans Callin** * Depuis la carte n8n, ouvrez n8n et suivez les instructions pour créer votre workflow et le relier à Callin (les étapes peuvent varier selon l’hébergement de votre n8n). **Exemples d’usage avec des agents IA** * À la fin d’un appel, déclencher un workflow qui avertit l’équipe et crée une tâche de suivi. * Router les résultats d’un échange vers des chemins différents (ex. : « démo planifiée » → alerter l’équipe commerciale ; « besoin de support » → créer un ticket). ### Zapier **À quoi ça sert**\ Zapier permet de connecter Callin à des milliers d’applications et d’automatiser des workflows simples sans développement sur mesure. **Comment le connecter dans Callin** 1. Depuis la carte Zapier, lancez la connexion. 2. Terminez l’autorisation. 3. Créez des automatisations du type “si ceci arrive, alors faire cela” selon votre besoin. **Exemples d’usage avec des agents IA** * Quand un agent collecte un nouveau prospect, déclencher une séquence de relance e-mail dans votre outil d’e-mailing. * Quand un appel est terminé, envoyer automatiquement un résumé vers une feuille de calcul ou un outil de suivi pour la visibilité. ### Make.com **À quoi ça sert**\ Make (anciennement Integromat) est une autre plateforme pour construire des scénarios multi-étapes entre outils. **Comment le connecter dans Callin** 1. Depuis la carte Make.com, lancez la connexion. 2. Suivez les étapes affichées pendant la configuration. 3. Construisez des scénarios dans Make qui correspondent à votre processus. **Exemples d’usage avec des agents IA** * Si un agent qualifie un prospect comme “forte intention”, déclencher un scénario multi-étapes (ex. : alerter un commercial, créer une opportunité, planifier une tâche). * Envoyer des mises à jour structurées vers des outils internes déjà utilisés par l’équipe. ### Slack (Bientôt disponible) **À quoi ça sert**\ Slack est souvent utilisé pour les notifications d’équipe et la communication interne. **Disponibilité**\ Sur la capture, Slack apparaît comme “bientôt disponible”, ce qui signifie qu’il est listé dans Actions mais pas encore connectable. **Exemples d’usage avec des agents IA (une fois disponible)** * Notifier un canal quand un agent planifie un rendez-vous (ex. : « Nouvelle démo planifiée : jeudi 14 h 00 »). * Alerter l’équipe support lorsqu’un client demande de l’aide pendant un appel. ### Intégration personnalisée **À quoi ça sert**\ L’intégration personnalisée est destinée aux équipes qui veulent relier Callin à leurs systèmes ou à des services externes via des webhooks. **Comment la connecter dans Callin** * Ouvrez la carte d’intégration personnalisée puis accédez à l’écran de gestion. * Configurez les paramètres de webhook disponibles (les champs et options peuvent varier selon votre compte ou votre offre). **Exemples d’usage avec des agents IA** * Envoyer le résultat d’un appel vers votre tableau de bord interne (ex. : « prospect qualifié », « relance nécessaire », « pas intéressé »). * Déclencher un flux dans votre backend chaque fois qu’un agent termine un type d’interaction précis. > **Conseil :** L’intégration personnalisée est idéale si vous avez déjà un outil interne et souhaitez que Callin lui envoie des événements. ## Dépannage ### L’intégration reste affichée comme non connectée * Rafraîchissez la page et vérifiez à nouveau. * Essayez de déconnecter puis de reconnecter (si l’option existe). * Vérifiez que vous vous êtes connecté avec le bon compte côté plateforme. ### Vous avez connecté le mauvais compte * Déconnectez l’intégration (si disponible) puis reconnectez-la en choisissant le bon compte lors de l’autorisation. ### Les boutons ou options sont différents Certains libellés et étapes peuvent varier selon votre offre, les réglages de votre organisation ou des changements chez le fournisseur. # Azioni Source: https://support.callin.io/Create-AI-Agent/Actions-copied-3 Collega Callin a piattaforme esterne (calendario, CRM, automazione e webhook) così i tuoi agenti IA possono attivare flussi di lavoro reali. ## Azioni Azioni è la sezione in cui colleghi Callin ad altre piattaforme, così i tuoi agenti IA possono **programmare appuntamenti**, **sincronizzare dati cliente**, **attivare automazioni** e **inviare aggiornamenti**—senza fare tutto a mano. [Apri Azioni nella console](https://app.callin.io/actions)Schermata: L’hub Azioni dove puoi collegare piattaforme esterne a Callin. Ogni scheda indica se è connessa e ti permette di avviare la connessione o gestire l’integrazione.
> **Consiglio:** Se non sai da dove iniziare, parti da un **calendario** (per le prenotazioni) o da una piattaforma di **automazione** (per follow-up e attività ripetitive). ## Dove trovarlo 1. Apri la console di Callin. 2. Nel menu a sinistra, entra nella sezione delle integrazioni e apri **Azioni**. ## Come funziona la connessione Ogni scheda di integrazione mostra uno stato e un pulsante di azione: * **Non connesso** → di solito vedrai un pulsante per avviare la connessione. * **Connesso** → possono comparire opzioni per vedere i dettagli e per disconnettere. * **In arrivo** → l’integrazione è visibile, ma non ancora collegabile (ad esempio, Slack). * Alcune piattaforme possono mostrare pulsanti con testi diversi a seconda dell’integrazione (ad esempio, un pulsante per aprire la piattaforma o per gestire la configurazione). Flusso generale: 1. Nella scheda dell’integrazione, premi il pulsante per **connettere** o **gestire**. 2. Segui i passaggi di autorizzazione o configurazione visualizzati. 3. Torna in Callin e verifica che lo stato della scheda sia aggiornato. > **Importante:** Le schermate di autorizzazione possono variare in base al tuo account, al tuo piano o alle regole di permesso della tua organizzazione. > **Errore comune:** Collegare l’account sbagliato (ad esempio un’altra email) e poi non trovare eventi o dati nel posto giusto. ## Integrazioni disponibili Di seguito trovi a cosa serve normalmente ciascuna piattaforma disponibile e come collegarla dalla pagina Azioni. ### Google Calendar **A cosa serve**\ Google Calendar ti aiuta a tenere gli appuntamenti organizzati in un calendario già usato dal team. **Come collegarlo in Callin** * Se non è connesso, avvia la connessione dalla scheda di Google Calendar e completa l’autorizzazione. * Se è già connesso, di solito trovi opzioni per visualizzare i dettagli e per disconnettere. **Esempi d’uso con agenti IA** * Un agente di prenotazione può coordinare gli orari e assicurarsi che gli appuntamenti confermati siano riportati nel calendario (es.: “Demo con Alex Rivera — martedì 15:30”). * Un agente può ridurre le mancate presentazioni usando il calendario come “fonte di verità” dei prossimi incontri (es.: “Sei prenotato per mercoledì alle 10:00”). ### Cal.com (Beta) **A cosa serve**\ Cal.com è una piattaforma di prenotazione appuntamenti. Collegarla può aiutare ad allineare Callin con la tua configurazione di scheduling. **Come collegarlo in Callin** 1. Trova Cal.com e usa il pulsante per collegare. 2. Segui i passaggi mostrati durante la configurazione (possono cambiare perché è in beta). 3. Torna su Azioni e verifica che non risulti più non connesso. **Esempi d’uso con agenti IA** * Un agente può guidare il cliente verso il tipo di appuntamento giusto (es.: “chiamata introduttiva 15 minuti” vs “onboarding 30 minuti”). * Se il team usa link di prenotazione Cal.com, un agente può indirizzare le persone all’opzione corretta in base all’esigenza (vendite, supporto, onboarding). > **Importante:** Essendo in beta, il flusso di configurazione e le opzioni disponibili possono cambiare. ### GoHighLevel **A cosa serve**\ GoHighLevel è una piattaforma CRM. Collegarla aiuta a mantenere allineate le informazioni di clienti e lead con i tuoi flussi CRM. **Come collegarlo in Callin** 1. Dalla scheda GoHighLevel, avvia la connessione. 2. Completa accesso e autorizzazione. 3. Verifica che lo stato passi a connesso. **Esempi d’uso con agenti IA** * Dopo una chiamata, un agente può aiutare a preparare i dettagli del lead per i follow-up (es.: nome, interesse e note sul prossimo passo). * Un agente commerciale può usare ciò che ha raccolto nella conversazione per migliorare il passaggio al team (es.: “Interessato al piano Pro, vuole i prezzi via email”). ### Zoho **A cosa serve**\ Zoho è un’altra opzione CRM. Usalo se il team gestisce lead, contatti o record clienti in Zoho. **Come collegarlo in Callin** 1. Dalla scheda Zoho, avvia la connessione. 2. Segui i passaggi di autorizzazione. 3. Verifica che lo stato indichi la connessione completata. **Esempi d’uso con agenti IA** * Un agente di supporto può aiutare a registrare l’esito di una chiamata per consentire al team di fare follow-up nel CRM. * Un agente può migliorare la qualità dei dati chiedendo informazioni mancanti durante la conversazione (es.: dimensione dell’azienda, canale di contatto preferito). ### n8n **A cosa serve**\ n8n è una piattaforma di automazione. È utile se vuoi creare automazioni personalizzate che collegano più strumenti. **Come collegarlo in Callin** * Dalla scheda n8n, apri n8n e segui le istruzioni per creare il workflow e collegarlo a Callin (i passaggi possono variare in base a come è ospitato n8n). **Esempi d’uso con agenti IA** * A fine chiamata, avviare un flusso che avvisa il team e crea un’attività di follow-up. * Instradare gli esiti delle conversazioni su percorsi diversi (es.: “demo prenotata” → avvisare le vendite; “serve supporto” → creare un ticket). ### Zapier **A cosa serve**\ Zapier ti permette di collegare Callin a migliaia di app e automatizzare flussi semplici senza sviluppo su misura. **Come collegarlo in Callin** 1. Dalla scheda Zapier, avvia la connessione. 2. Completa l’autorizzazione. 3. Crea automazioni “se succede questo, allora fai quello” in base alle tue esigenze. **Esempi d’uso con agenti IA** * Quando un agente raccoglie un nuovo lead, attivare una sequenza di follow-up via email nel tuo strumento di posta. * Quando una chiamata termina, inviare automaticamente un riepilogo a un foglio di calcolo o a un task manager per visibilità. ### Make.com **A cosa serve**\ Make (prima Integromat) è un’altra piattaforma per costruire scenari multi-step tra strumenti. **Come collegarlo in Callin** 1. Dalla scheda Make.com, avvia la connessione. 2. Segui i passaggi mostrati durante la configurazione. 3. Costruisci scenari in Make che rispecchiano il tuo processo. **Esempi d’uso con agenti IA** * Se un agente qualifica un lead come “alta intenzione”, attivare uno scenario multi-step (es.: avvisare un commerciale, creare un’opportunità, pianificare un’attività). * Inviare aggiornamenti strutturati verso strumenti interni già usati dal team. ### Slack (In arrivo) **A cosa serve**\ Slack è spesso usato per notifiche al team e comunicazione interna. **Disponibilità**\ Nella schermata, Slack risulta “in arrivo”, cioè è visibile in Azioni ma non ancora collegabile. **Esempi d’uso con agenti IA (quando disponibile)** * Notificare un canale quando un agente prenota un appuntamento (es.: “Nuova demo prenotata: giovedì 14:00”). * Avvisare il supporto quando un cliente chiede aiuto durante una chiamata. ### Integrazione personalizzata **A cosa serve**\ L’integrazione personalizzata è pensata per i team che vogliono collegare Callin ai propri sistemi o a servizi esterni tramite webhooks. **Come collegarla in Callin** * Apri la scheda dell’integrazione personalizzata e accedi alla schermata di gestione. * Configura lì le impostazioni webhook disponibili (campi e opzioni possono variare in base al tuo account o piano). **Esempi d’uso con agenti IA** * Inviare l’esito di una chiamata al tuo cruscotto interno (es.: “Lead qualificato”, “Serve follow-up”, “Non interessato”). * Attivare un flusso nel tuo backend ogni volta che un agente completa un tipo specifico di interazione. > **Consiglio:** L’integrazione personalizzata è ideale se hai già uno strumento interno e vuoi che Callin invii eventi verso di esso. ## Risoluzione dei problemi ### L’integrazione resta indicata come non connessa * Aggiorna la pagina e controlla di nuovo. * Prova a disconnettere e riconnettere (se l’opzione esiste). * Verifica di aver effettuato l’accesso con l’account corretto sulla piattaforma. ### Hai collegato l’account sbagliato * Disconnetti l’integrazione (se disponibile) e riconnettila scegliendo l’account corretto durante l’autorizzazione. ### Pulsanti o opzioni appaiono diversi Alcune etichette e passaggi possono variare in base al tuo piano, alle impostazioni dell’organizzazione o a cambiamenti del fornitore. # Aktionen Source: https://support.callin.io/Create-AI-Agent/Actions-copied-4 Verbinde Callin mit externen Plattformen (Kalender, CRM, Automatisierung und Webhooks), damit deine KI-Agenten reale Workflows auslösen können. ## Aktionen Aktionen ist der Bereich, in dem du Callin mit anderen Plattformen verbindest, damit deine KI-Agenten **Termine planen**, **Kundendaten synchronisieren**, **Automatisierungen auslösen** und **Updates senden** können—ohne alles manuell erledigen zu müssen. [Aktionen in der Konsole öffnen](https://app.callin.io/actions)Screenshot: Der Aktionen-Hub, in dem du externe Plattformen mit Callin verbinden kannst. Jede Karte zeigt den Verbindungsstatus und ermöglicht das Verbinden oder Verwalten der Integration.
> **Tipp:** Wenn du unsicher bist, starte mit einem **Kalender** (für Buchungen) oder einer **Automatisierungs-Plattform** (für Follow-ups und wiederkehrende Aufgaben). ## Wo du es findest 1. Öffne deine Callin-Konsole. 2. Gehe im linken Menü in den Integrationsbereich und öffne **Aktionen**. ## So funktioniert das Verbinden Jede Integrationskarte zeigt einen Status und eine Aktion: * **Nicht verbunden** → meist gibt es einen Button, um die Verbindung zu starten. * **Verbunden** → oft erscheinen Optionen, um Details anzusehen und die Verbindung zu trennen. * **Demnächst** → die Integration wird angezeigt, ist aber noch nicht verbindbar (z. B. Slack). * Je nach Integration können Buttons anders benannt sein (z. B. ein Button, um zur Plattform zu wechseln oder Einstellungen zu verwalten). Allgemeiner Ablauf: 1. Klicke auf der Integrationskarte auf den Button zum **Verbinden** oder **Verwalten**. 2. Folge den angezeigten Autorisierungs- oder Einrichtungsschritten. 3. Kehre zu Callin zurück und prüfe, ob sich der Status der Karte aktualisiert hat. > **Wichtig:** Die Autorisierungsbildschirme können je nach Konto, Tarif oder Berechtigungsverwaltung in deiner Organisation abweichen. > **Häufiger Fehler:** Das falsche Konto verbinden (z. B. eine andere E-Mail) und sich danach wundern, warum Events oder Daten nicht dort auftauchen, wo man sie erwartet. ## Verfügbare Integrationen Unten findest du, wofür die jeweils verfügbare Plattform typischerweise genutzt wird und wie du sie in Aktionen verbindest. ### Google Calendar **Wofür es ist**\ Mit Google Calendar hältst du Termine in einem Kalender fest, den dein Team bereits nutzt. **So verbindest du es in Callin** * Wenn es noch nicht verbunden ist, starte die Verbindung über die Google-Calendar-Karte und schließe die Autorisierung ab. * Wenn es bereits verbunden ist, gibt es in der Regel Optionen, um die Verbindung anzusehen und zu trennen. **Beispiele mit KI-Agenten** * Ein Buchungsagent kann Zeiten koordinieren und sicherstellen, dass bestätigte Termine im Kalender erscheinen (z. B.: „Demo mit Alex Rivera — Dienstag 15:30“). * Ein Agent kann helfen, No-Shows zu reduzieren, indem er den Kalender als „Single Source of Truth“ für bevorstehende Termine nutzt (z. B.: „Du bist für Mittwoch um 10:00 eingeplant“). ### Cal.com (Beta) **Wofür es ist**\ Cal.com ist eine Terminplanungsplattform. Die Verbindung kann helfen, Callin mit deinem Scheduling-Setup zu synchronisieren. **So verbindest du es in Callin** 1. Suche Cal.com und starte die Verbindung über die Karte. 2. Folge den Einrichtungsschritten (sie können sich ändern, da es als Beta markiert ist). 3. Gehe zurück zu Aktionen und prüfe, ob die Integration nicht mehr als nicht verbunden angezeigt wird. **Beispiele mit KI-Agenten** * Ein Agent kann Kundinnen und Kunden zum passenden Termin-Typ führen (z. B.: „15-Minuten Kennenlernanruf“ vs. „30-Minuten Onboarding“). * Wenn dein Team Cal.com-Buchungslinks nutzt, kann ein Agent dabei helfen, je nach Anliegen zur richtigen Option zu leiten (Vertrieb, Support, Onboarding). > **Wichtig:** Da die Integration als Beta gekennzeichnet ist, können sich Einrichtung und verfügbare Optionen ändern. ### GoHighLevel **Wofür es ist**\ GoHighLevel ist eine CRM-Plattform. Die Verbindung hilft, Lead- und Kundendaten zwischen Callin und deinen CRM-Workflows konsistent zu halten. **So verbindest du es in Callin** 1. Starte die Verbindung über die GoHighLevel-Karte. 2. Schließe Anmeldung und Autorisierung ab. 3. Prüfe, ob der Status auf verbunden wechselt. **Beispiele mit KI-Agenten** * Nach einem Anruf kann ein Agent helfen, Lead-Details für Follow-ups bereitzustellen (z. B.: Name, Interesse und nächste Schritte). * Ein Vertriebsagent kann Erkenntnisse aus dem Gespräch für bessere Übergaben nutzen (z. B.: „Interessiert am Pro-Tarif, möchte Preise per E-Mail“). ### Zoho **Wofür es ist**\ Zoho ist eine weitere CRM-Option. Nutze es, wenn dein Team Leads, Kontakte oder Kundendatensätze in Zoho verwaltet. **So verbindest du es in Callin** 1. Starte die Verbindung über die Zoho-Karte. 2. Folge den Autorisierungsschritten. 3. Prüfe, ob der Status auf verbunden wechselt. **Beispiele mit KI-Agenten** * Ein Support-Agent kann helfen, das Ergebnis eines Gesprächs festzuhalten, damit das Team im CRM nachfassen kann. * Ein Agent kann Datenqualität verbessern, indem er fehlende Infos im Gespräch abfragt (z. B.: Unternehmensgröße, bevorzugter Kontaktkanal). ### n8n **Wofür es ist**\ n8n ist eine Automatisierungsplattform. Sie ist hilfreich, wenn du individuelle Automationen bauen möchtest, die mehrere Tools verbinden. **So verbindest du es in Callin** * Öffne n8n über die n8n-Karte und folge den Anweisungen, um einen Workflow zu erstellen und ihn mit Callin zu verbinden (die Schritte können je nach Hosting variieren). **Beispiele mit KI-Agenten** * Nach einem Gespräch einen Workflow auslösen, der das Team informiert und eine Follow-up-Aufgabe erstellt. * Gesprächsergebnisse in unterschiedliche Pfade leiten (z. B.: „Demo gebucht“ → Vertrieb informieren; „braucht Support“ → Ticket erstellen). ### Zapier **Wofür es ist**\ Zapier verbindet Callin mit tausenden Apps und automatisiert einfache Workflows ohne individuelle Entwicklung. **So verbindest du es in Callin** 1. Starte die Verbindung über die Zapier-Karte. 2. Schließe die Autorisierung ab. 3. Erstelle Automationen nach dem Prinzip „wenn dies passiert, dann tue das“. **Beispiele mit KI-Agenten** * Wenn ein Agent einen neuen Lead erfasst, eine E-Mail-Follow-up-Sequenz in deinem E-Mail-Tool starten. * Nach Abschluss eines Anrufs automatisch eine Zusammenfassung in eine Tabelle oder ein Aufgaben-Tool senden. ### Make.com **Wofür es ist**\ Make (früher Integromat) ist eine weitere Plattform, um mehrstufige Szenarien zwischen Tools zu bauen. **So verbindest du es in Callin** 1. Starte die Verbindung über die Make.com-Karte. 2. Folge den Einrichtungsschritten. 3. Erstelle Szenarien in Make, die zu deinem Prozess passen. **Beispiele mit KI-Agenten** * Wenn ein Agent einen Lead als „hohe Kaufabsicht“ einstuft, ein mehrstufiges Szenario starten (z. B.: Vertrieb benachrichtigen, Opportunity anlegen, Aufgabe planen). * Strukturierte Updates an interne Tools senden, die dein Team bereits nutzt. ### Slack (Demnächst) **Wofür es ist**\ Slack wird häufig für Team-Benachrichtigungen und interne Kommunikation genutzt. **Verfügbarkeit**\ Im Screenshot ist Slack als „demnächst“ gekennzeichnet—es wird angezeigt, ist aber noch nicht verbindbar. **Beispiele mit KI-Agenten (sobald verfügbar)** * Einen Channel benachrichtigen, wenn ein Agent einen Termin bucht (z. B.: „Neue Demo gebucht: Donnerstag 14:00“). * Den Support alarmieren, wenn während eines Anrufs Hilfe angefragt wird. ### Benutzerdefinierte Integration **Wofür es ist**\ Die benutzerdefinierte Integration ist für Teams gedacht, die Callin über Webhooks mit eigenen Systemen oder externen Services verbinden möchten. **So verbindest du es in Callin** * Öffne die Karte der benutzerdefinierten Integration und gehe in den Verwaltungsbereich. * Konfiguriere dort die verfügbaren Webhook-Einstellungen (Felder und Optionen können je nach Konto oder Tarif variieren). **Beispiele mit KI-Agenten** * Das Ergebnis eines Anrufs an ein internes Dashboard senden (z. B.: „Lead qualifiziert“, „Follow-up nötig“, „Nicht interessiert“). * Einen Prozess in deinem Backend auslösen, sobald ein Agent eine bestimmte Art von Interaktion abgeschlossen hat. > **Tipp:** Die benutzerdefinierte Integration ist ideal, wenn du bereits ein internes Tool hast und möchtest, dass Callin Events dorthin sendet. ## Fehlerbehebung ### Die Integration bleibt als nicht verbunden sichtbar * Lade die Seite neu und prüfe erneut. * Trenne die Verbindung und verbinde sie erneut (falls diese Option vorhanden ist). * Stelle sicher, dass du dich auf der Plattform mit dem richtigen Konto angemeldet hast. ### Du hast das falsche Konto verbunden * Trenne die Verbindung (falls verfügbar) und verbinde sie erneut, dabei das richtige Konto auswählen. ### Buttons oder Optionen sehen anders aus Einige Bezeichnungen und Schritte können je nach Tarif, Organisations-Einstellungen oder Änderungen beim Anbieter variieren. # Call History Source: https://support.callin.io/Create-AI-Agent/Call-Actions Filter, export, and analyze past calls. Open call details to review the recording, transcript, and insights, and download audio when available. ## Overview **Call History** is where you review past calls in your workspace. From this page you can: * **Search and filter** calls (by phone number, agent, status, date range, and more) * **See call outcomes** (for example, whether an appointment or voicemail was detected) * **Export** the current list to **CSV** * **Open call details** to analyze the conversation (recording, transcript, summary, key moments, sentiments) * **Download** the call recording (when available) Use this direct link to open the page: [Open Call History](https://app.callin.io/call-history) > **Tip:** Bookmark the link above if you review calls every day. ## Open Call History 1. In the left sidebar, go to **Evaluate**. 2. Click **Call History**. ## Filter and search calls At the top of the page you’ll typically see two main actions: * **Filters** (to narrow down the list) * **Export CSV** (to download the results) The filter area includes fields like the following (availability can vary by account/plan): | Filter | What it helps you do | Example | | -------------- | ----------------------------------------------- | -------------------- | | Phone Number | Find calls for a specific number | Search for “+1 415…” | | Call ID | Jump to a specific call | Paste a call ID | | Handling Agent | See calls handled by a specific agent | “Sales Agent 1” | | Status | Filter by call status | “Completed” | | Direction | Separate inbound vs outbound calls | “Inbound” | | Date Range | Focus on a time window | “Last 7 days” | | Call Duration | Filter by length | “Over 1 minute” | | Call Origin | Identify where the call came from | “Application” | | Campaign ID | Filter by campaign identifier | Paste an ID | | Appointment | Find calls with an appointment detected | “All” / filtered | | Call Transfer | Find calls with transfer activity | “All” / filtered | | Machine | Find calls where voicemail/machine was detected | “All” / filtered | > **Common mistake:** Applying too many filters at once can return no results. If the table looks empty, remove one filter and try again.Screenshot: Use the filter panel to narrow down calls before exporting or opening call details.
## Understand call outcomes (icons) In the calls table, you may see a **Call Outcomes** column with icons that summarize what was detected during the call. * **Calendar icon**: An **appointment** was detected for that call. * If you **hover your mouse** over the calendar icon, you’ll see the appointment details. * **Robot head icon**: A **voicemail / answering machine** was detected (the agent identified a voicemail). > **Important:** Which outcomes appear can vary depending on what the system detects on each call. ## Export Call History to CSV You can export the calls you’re currently seeing (including any filters you applied). 1. Click **Export CSV**. 2. In the export window, select the **columns** you want to include. * You can use **Select All** or **Deselect All** to speed things up. 3. Click **Export CSV** to download the file. > **Tip:** If you want “all calls,” clear filters before exporting. ## Open call details to analyze a call To view everything about a specific call: 1. Click any call row in the table. 2. A **Call Details** panel opens on the right. Inside **Call Details**, you can review and analyze the conversation. Depending on your account/plan, you may see: * **Call Recording** player (with playback controls) * A menu with **playback speed** options * Tabs such as: * **Call Transcript** * **Summary** * **Key Moments** * **Sentiments** * Actions like **Copy** (for example, to copy the transcript or selected content) * Options to **download** items such as the **transcript** (availability can vary) > **Tip:** Use the transcript search box to quickly find a specific phrase or moment in the call. ## Download call audio (recording) To download the audio for a call (when a recording is available): 1. Click a call row to open **Call Details**. 2. In the **Call Recording** card, click the **three-dots (… )** menu. 3. Select **Download Recording**. In the same menu, you can also adjust playback **Speed** (for example 0.5x, 0.75x, 1x, 1.25x, 1.5x, 2x). > **Important:** If you don’t see **Download Recording**, recording may not be available for that call, or access can vary by plan and permissions.Screenshot: Open a call, then use the “…” menu in Call Recording to change speed or download the audio.
# Anrufverlauf Source: https://support.callin.io/Create-AI-Agent/Call-Actions-copied-1 Filtern, exportieren und analysieren Sie vergangene Anrufe. Öffnen Sie die Anrufdetails, um Aufnahme, Transkript und Einblicke anzusehen, und laden Sie das Audio herunter, wenn verfügbar. ## Überblick **Anrufverlauf** ist der Bereich, in dem Sie vergangene Anrufe in Ihrem Workspace überprüfen. Auf dieser Seite können Sie: * **Anrufe suchen und filtern** (nach Telefonnummer, Agent, Status, Datumsbereich und mehr) * **Anrufergebnisse sehen** (z. B. ob ein Termin oder eine Mailbox erkannt wurde) * **Die aktuelle Liste** als **CSV** **exportieren** * **Anrufdetails öffnen**, um das Gespräch zu analysieren (Aufnahme, Transkript, Zusammenfassung, Schlüsselmomente, Stimmungen) * **Die Anrufaufnahme herunterladen** (wenn verfügbar) Nutzen Sie diesen Direktlink, um die Seite zu öffnen: [Anrufverlauf öffnen](https://app.callin.io/call-history) > **Tipp:** Speichern Sie den Link als Lesezeichen, wenn Sie den Anrufverlauf täglich nutzen. ## Anrufverlauf öffnen 1. Gehen Sie in der linken Seitenleiste zum Bereich **Auswertung**. 2. Klicken Sie auf **Anrufverlauf**. ## Anrufe filtern und suchen Oben auf der Seite sehen Sie in der Regel zwei Hauptaktionen: * **Filter** (um die Liste einzugrenzen) * **CSV exportieren** (um die Ergebnisse herunterzuladen) Der Filterbereich enthält Felder wie die folgenden (die Verfügbarkeit kann je nach Konto/Plan variieren): | Filter | Wobei es hilft | Beispiel | | ------------------ | -------------------------------------------- | --------------------- | | Telefonnummer | Anrufe für eine bestimmte Nummer finden | Suchen nach „+1 415…“ | | Anruf-ID | Direkt zu einem bestimmten Anruf springen | Anruf-ID einfügen | | Zuständiger Agent | Anrufe eines bestimmten Agents sehen | „Sales Agent 1“ | | Status | Nach Anrufstatus filtern | „Abgeschlossen“ | | Richtung | Eingehend vs. ausgehend trennen | „Eingehend“ | | Datumsbereich | Auf einen Zeitraum fokussieren | „Letzte 7 Tage“ | | Anrufdauer | Nach Dauer filtern | „Über 1 Minute“ | | Anrufursprung | Erkennen, woher der Anruf kommt | „Anwendung“ | | Kampagnen-ID | Nach Kampagnenkennung filtern | ID einfügen | | Termin | Anrufe mit erkanntem Termin finden | „Alle“ / gefiltert | | Anrufweiterleitung | Anrufe mit Weiterleitungen finden | „Alle“ / gefiltert | | Maschine | Anrufe mit erkannter Mailbox/Maschine finden | „Alle“ / gefiltert | > **Häufiger Fehler:** Zu viele Filter gleichzeitig können zu keinen Ergebnissen führen. Wenn die Tabelle leer ist, entfernen Sie einen Filter und versuchen Sie es erneut.Screenshot: Nutzen Sie das Filterpanel, um die Liste einzugrenzen, bevor Sie exportieren oder Anrufdetails öffnen.
## Anrufergebnisse verstehen (Symbole) In der Anruftabelle sehen Sie möglicherweise eine Spalte mit **Anrufergebnissen** und Symbolen, die zusammenfassen, was während des Anrufs erkannt wurde. * **Kalender-Symbol**: Für diesen Anruf wurde ein **Termin** erkannt. * Wenn Sie mit der Maus über das Kalender-Symbol fahren, sehen Sie die Termindetails. * **Roboterkopf-Symbol**: Eine **Mailbox / ein Anrufbeantworter** wurde erkannt (der Agent hat eine Mailbox identifiziert). > **Wichtig:** Welche Ergebnisse angezeigt werden, kann je nach Erkennung pro Anruf variieren. ## Anrufverlauf als CSV exportieren Sie können die aktuell angezeigten Anrufe exportieren (einschließlich angewendeter Filter). 1. Klicken Sie auf **CSV exportieren**. 2. Wählen Sie im Exportfenster die **Spalten** aus, die enthalten sein sollen. * Mit **Alles auswählen** oder **Alles abwählen** geht es schneller. 3. Klicken Sie auf **CSV exportieren**, um die Datei herunterzuladen. > **Tipp:** Wenn Sie „alle Anrufe“ exportieren möchten, entfernen Sie vorher die Filter. ## Anrufdetails öffnen, um einen Anruf zu analysieren So sehen Sie alle Details zu einem bestimmten Anruf: 1. Klicken Sie in der Tabelle auf eine Anrufzeile. 2. Rechts öffnet sich ein Panel **Anrufdetails**. In den **Anrufdetails** können Sie das Gespräch ansehen und analysieren. Je nach Konto/Plan sehen Sie möglicherweise: * Einen Player für die **Anrufaufnahme** (mit Wiedergabesteuerung) * Ein Menü mit Optionen zur **Wiedergabegeschwindigkeit** * Tabs wie: * **Anruftranskript** * **Zusammenfassung** * **Schlüsselmomente** * **Stimmungen** * Aktionen wie **Kopieren** (z. B. um das Transkript oder ausgewählte Inhalte zu kopieren) * Optionen zum **Herunterladen** von Inhalten wie dem **Transkript** (Verfügbarkeit kann variieren) > **Tipp:** Nutzen Sie die Suche im Transkript, um schnell eine bestimmte Formulierung oder Stelle zu finden. ## Anruf-Audio herunterladen (Aufnahme) So laden Sie das Audio eines Anrufs herunter (wenn eine Aufnahme verfügbar ist): 1. Klicken Sie auf eine Anrufzeile, um die **Anrufdetails** zu öffnen. 2. Klicken Sie in der Karte **Anrufaufnahme** auf das Menü **drei Punkte (… )**. 3. Wählen Sie **Aufnahme herunterladen**. Im selben Menü können Sie auch die **Geschwindigkeit** anpassen (z. B. 0,5x, 0,75x, 1x, 1,25x, 1,5x, 2x). > **Wichtig:** Wenn **Aufnahme herunterladen** nicht angezeigt wird, ist die Aufnahme für diesen Anruf möglicherweise nicht verfügbar oder der Zugriff hängt von Plan und Berechtigungen ab.Screenshot: Öffnen Sie einen Anruf und verwenden Sie das Menü „…“ in der Aufnahme, um die Geschwindigkeit zu ändern oder das Audio herunterzuladen.
# Historial de llamadas Source: https://support.callin.io/Create-AI-Agent/Call-Actions-copied-2 Filtra, exporta y analiza llamadas anteriores. Abre los detalles para revisar la grabación, la transcripción y los insights, y descarga el audio cuando esté disponible. ## Visión general **Historial de llamadas** es el lugar donde revisas llamadas anteriores en tu espacio de trabajo. Desde esta página puedes: * **Buscar y filtrar** llamadas (por número de teléfono, agente, estado, rango de fechas y más) * **Ver resultados de la llamada** (por ejemplo, si se detectó una cita o un buzón de voz) * **Exportar** la lista actual a **CSV** * **Abrir los detalles de la llamada** para analizar la conversación (grabación, transcripción, resumen, momentos clave, sentimientos) * **Descargar** la grabación de la llamada (cuando esté disponible) Puedes abrir la página directamente desde este enlace: [Abrir Historial de llamadas](https://app.callin.io/call-history) > **Consejo:** Guarda el enlace anterior en favoritos si revisas llamadas todos los días. ## Abrir el Historial de llamadas 1. En el menú lateral izquierdo, ve a la sección de evaluación. 2. Abre **Historial de llamadas**. > **Importante:** Los nombres del menú pueden variar según tu cuenta o plan. ## Filtrar y buscar llamadas En la parte superior de la página normalmente verás dos acciones principales: * Un botón para **filtrar** (para acotar la lista) * Un botón para **exportar a CSV** (para descargar los resultados) El área de filtros incluye campos como los siguientes (la disponibilidad puede variar según tu cuenta/plan): | Filtro | Para qué sirve | Ejemplo | | ------------------------ | ------------------------------------------------- | ---------------------- | | Número de teléfono | Encontrar llamadas de un número concreto | Buscar “+1 415…” | | ID de llamada | Ir a una llamada específica | Pegar un ID de llamada | | Agente que atendió | Ver llamadas gestionadas por un agente | “Agente de ventas 1” | | Estado | Filtrar por estado | “Completada” | | Dirección | Separar entrantes vs. salientes | “Entrante” | | Rango de fechas | Acotar por fechas | “Últimos 7 días” | | Duración de la llamada | Filtrar por duración | “Más de 1 minuto” | | Origen de la llamada | Identificar de dónde viene la llamada | “Aplicación” | | ID de campaña | Filtrar por identificador de campaña | Pegar un ID | | Cita | Encontrar llamadas con cita detectada | “Todas” / filtrado | | Transferencia de llamada | Encontrar llamadas con transferencia | “Todas” / filtrado | | Máquina | Encontrar llamadas donde se detectó buzón/máquina | “Todas” / filtrado | > **Error común:** Aplicar demasiados filtros a la vez puede devolver cero resultados. Si la tabla aparece vacía, quita un filtro y prueba de nuevo.Captura: usa el panel de filtros para acotar llamadas antes de exportar o abrir los detalles.
## Entender los resultados de la llamada (iconos) En la tabla de llamadas, puede aparecer una columna de **resultados** con iconos que resumen lo que se detectó durante la llamada. * **Icono de calendario**: Se detectó una **cita** en esa llamada. * Si pones el **ratón encima** del calendario, verás los detalles de la cita. * **Icono de cabeza de robot**: Se detectó **buzón de voz / contestador** (el agente identificó un buzón de voz). > **Importante:** Qué resultados aparecen puede variar según lo que el sistema detecte en cada llamada. ## Exportar el Historial de llamadas a CSV Puedes exportar las llamadas que estás viendo (incluyendo los filtros que hayas aplicado). 1. Haz clic en el botón de **exportar a CSV**. 2. En la ventana de exportación, selecciona las **columnas** que quieres incluir. * Puedes usar las opciones de **seleccionar todo** o **deseleccionar todo** para hacerlo más rápido. 3. Confirma la exportación para descargar el archivo. > **Consejo:** Si necesitas “todas las llamadas”, limpia los filtros antes de exportar. ## Abrir los detalles de una llamada para analizarla Para ver toda la información de una llamada concreta: 1. Haz clic en cualquier fila de llamada de la tabla. 2. Se abre un panel de **detalles de la llamada** a la derecha. Dentro de los detalles, puedes revisar y analizar la conversación. Según tu cuenta/plan, puedes ver: * Reproductor de **grabación** (con controles de reproducción) * Un menú con opciones de **velocidad de reproducción** * Pestañas de análisis, como: * **Transcripción de la llamada** * **Resumen** * **Momentos clave** * **Sentimientos** * Acciones como **copiar** (por ejemplo, para copiar la transcripción o contenido seleccionado) * Opciones para **descargar** elementos como la **transcripción** (la disponibilidad puede variar) > **Consejo:** Usa el buscador de la transcripción para encontrar rápidamente una frase o momento concreto de la llamada. ## Descargar el audio de la llamada (grabación) Para descargar el audio de una llamada (cuando haya grabación disponible): 1. Haz clic en una fila de llamada para abrir los **detalles**. 2. En la tarjeta de **grabación**, haz clic en el menú de **tres puntos (… )**. 3. Selecciona la opción de **descargar la grabación**. En ese mismo menú también puedes ajustar la **velocidad** (por ejemplo 0,5x, 0,75x, 1x, 1,25x, 1,5x, 2x). > **Importante:** Si no ves la opción de descarga, puede que no haya grabación para esa llamada, o que el acceso varíe según tu plan y permisos.Captura: abre una llamada y usa el menú “…” de la grabación para cambiar la velocidad o descargar el audio.
# Historique des appels Source: https://support.callin.io/Create-AI-Agent/Call-Actions-copied-4 Filtrez, exportez et analysez les appels passés. Ouvrez les détails d’un appel pour consulter l’enregistrement, la transcription et les informations clés, et télécharger l’audio lorsqu’il est disponible. ## Présentation **Historique des appels** est l’endroit où vous consultez les appels passés dans votre espace de travail. Depuis cette page, vous pouvez : * **Rechercher et filtrer** les appels (par numéro de téléphone, agent, statut, période, etc.) * **Voir les résultats de l’appel** (par exemple, si un rendez-vous ou une messagerie vocale a été détecté) * **Exporter** la liste actuelle en **CSV** * **Ouvrir les détails d’un appel** pour analyser la conversation (enregistrement, transcription, résumé, moments clés, sentiments) * **Télécharger** l’enregistrement de l’appel (lorsqu’il est disponible) Utilisez ce lien direct pour ouvrir la page : [Ouvrir l’historique des appels](https://app.callin.io/call-history) > **Conseil :** Ajoutez le lien ci-dessus à vos favoris si vous consultez les appels chaque jour. ## Ouvrir l’historique des appels 1. Dans la barre latérale gauche, allez dans la section **Évaluation**. 2. Cliquez sur **Historique des appels**. ## Filtrer et rechercher des appels En haut de la page, vous verrez généralement deux actions principales : * **Filtres** (pour réduire la liste) * **Exporter en CSV** (pour télécharger les résultats) La zone de filtres comprend des champs comme les suivants (la disponibilité peut varier selon votre compte/forfait) : | Filtre | À quoi ça sert | Exemple | | ------------------- | --------------------------------------------------- | -------------------- | | Numéro de téléphone | Trouver les appels d’un numéro précis | Rechercher “+1 415…” | | ID de l’appel | Accéder à un appel précis | Coller un ID d’appel | | Agent en charge | Voir les appels gérés par un agent | “Agent commercial 1” | | Statut | Filtrer par statut de l’appel | “Terminé” | | Sens | Séparer les entrants et les sortants | “Entrant” | | Plage de dates | Se concentrer sur une période | “7 derniers jours” | | Durée de l’appel | Filtrer par durée | “Plus d’1 minute” | | Origine de l’appel | Identifier la source de l’appel | “Application” | | ID de campagne | Filtrer par identifiant de campagne | Coller un ID | | Rendez-vous | Trouver les appels avec rendez-vous détecté | “Tous” / filtré | | Transfert d’appel | Trouver les appels avec transfert | “Tous” / filtré | | Machine | Trouver les appels avec messagerie/machine détectée | “Tous” / filtré | > **Erreur fréquente :** Appliquer trop de filtres à la fois peut ne renvoyer aucun résultat. Si le tableau est vide, retirez un filtre et réessayez.Capture : utilisez le panneau de filtres pour affiner la liste avant d’exporter ou d’ouvrir les détails d’un appel.
## Comprendre les résultats de l’appel (icônes) Dans le tableau des appels, vous pouvez voir une colonne de **résultats de l’appel** avec des icônes qui résument ce qui a été détecté pendant l’appel. * **Icône calendrier** : un **rendez-vous** a été détecté pour cet appel. * Si vous survolez l’icône calendrier avec la souris, vous verrez les détails du rendez-vous. * **Icône tête de robot** : une **messagerie vocale / répondeur** a été détectée (l’agent a identifié une messagerie). > **Important :** Les résultats affichés peuvent varier selon ce que le système détecte pour chaque appel. ## Exporter l’historique des appels en CSV Vous pouvez exporter les appels que vous voyez actuellement (y compris les filtres appliqués). 1. Cliquez sur **Exporter en CSV**. 2. Dans la fenêtre d’export, sélectionnez les **colonnes** à inclure. * Vous pouvez utiliser **Tout sélectionner** ou **Tout désélectionner** pour aller plus vite. 3. Cliquez sur **Exporter en CSV** pour télécharger le fichier. > **Conseil :** Si vous voulez “tous les appels”, supprimez les filtres avant l’export. ## Ouvrir les détails d’un appel pour l’analyser Pour afficher tout ce qui concerne un appel précis : 1. Cliquez sur une ligne d’appel dans le tableau. 2. Un panneau **Détails de l’appel** s’ouvre à droite. Dans les **détails de l’appel**, vous pouvez consulter et analyser la conversation. Selon votre compte/forfait, vous pouvez voir : * Un lecteur d’**enregistrement de l’appel** (avec des commandes de lecture) * Un menu avec des options de **vitesse de lecture** * Des onglets comme : * **Transcription de l’appel** * **Résumé** * **Moments clés** * **Sentiments** * Des actions comme **Copier** (par exemple pour copier la transcription ou un contenu sélectionné) * Des options pour **télécharger** des éléments comme la **transcription** (la disponibilité peut varier) > **Conseil :** Utilisez la barre de recherche de la transcription pour retrouver rapidement une phrase ou un moment précis. ## Télécharger l’audio de l’appel (enregistrement) Pour télécharger l’audio d’un appel (lorsqu’un enregistrement est disponible) : 1. Cliquez sur une ligne d’appel pour ouvrir les **détails de l’appel**. 2. Dans la carte **Enregistrement de l’appel**, cliquez sur le menu **trois points (… )**. 3. Sélectionnez **Télécharger l’enregistrement**. Dans ce même menu, vous pouvez aussi ajuster la **vitesse** (par exemple 0,5x, 0,75x, 1x, 1,25x, 1,5x, 2x). > **Important :** Si vous ne voyez pas **Télécharger l’enregistrement**, l’enregistrement n’est peut-être pas disponible pour cet appel, ou l’accès peut varier selon votre forfait et vos autorisations.Capture : ouvrez un appel, puis utilisez le menu “…” dans l’enregistrement pour changer la vitesse ou télécharger l’audio.
# Call transfer Source: https://support.callin.io/Create-AI-Agent/Call-Transfer Learn how to configure, activate, and manage call transfers within Callin.io to ensure your AI agent connects customers to the right team. ## Overview Call transfers allow your AI assistant to seamlessly redirect incoming calls to the correct department, team, or external number — without hanging up or causing delays. This feature ensures a professional customer experience and helps your organization manage calls efficiently. You’ll complete this setup in two main steps: creating a **transfer configuration** and linking it to your **AI agent**. *** ## Step 1: Create a Transfer Configuration 1. **Open the Call Transfer Page**\ In your Callin.io dashboard, open the left-hand menu and select **Call Transfer**. * If you’re setting this up for the first time, you’ll see a message saying **“No Call Transfer Configurations found.”** * Click **+ Create Configuration** to begin. 2. **Complete the Basic Information Section**\ This section helps identify and organize your transfer rules. * **Title:** The internal name for this configuration (for example, *Sales LATAM* or *Support Team*). * **Department:** The team or group responsible for handling the transferred calls. Both fields are required. If left blank, a red alert (e.g., *“Title is required!”*) will appear to prompt completion. 3. **Add Transfer Details**\ Define where the call should be redirected and what happens during the transfer process. * Click **+ Add** and complete these fields: * **Agent Name:** This is pre-filled by default, identifying the current AI agent. * **Transfer Phone Number:** The phone number to which calls will be transferred (for example, `+44 700123456`). * **Transfer Message:** The short message your AI agent says before transferring the call (for example, *“Let me connect you with our sales department, one moment please.”*). Click **Save** once you’ve filled in all fields. The configuration will now appear in your **Call Transfer** list. *** ## Step 2: Activate Call Transfer for an AI Agent Once the configuration is ready, you can activate it for any of your AI agents. 1. Go to **AI Agents** in the main navigation menu. 2. Select the agent you want to enable call transfers for. 3. Open the **Call Action** tab in the agent settings. 4. Locate the **Transfer Call** option and toggle it on. The toggle will turn blue to indicate activation. 5. Click the ⚙️ **gear icon** next to the toggle. This opens a configuration panel listing all available transfer setups. 6. Select the configuration you just created (for example, *Sales LATAM*). Once selected, it will appear as **Selected** in green text. This process links the configuration to your agent and prepares it for use in live calls. *** ## Step 3: Save and Test the Setup After assigning the transfer rule, scroll to the lower-right corner of the agent page and click **Save**. If a message appears saying *“You have unsaved changes,”* the configuration has not been stored yet — click **Save** again to confirm. Once saved, your AI agent can now detect when a call should be redirected and perform the transfer automatically in real time. ### Testing Your Configuration To ensure the setup works as expected: * Go to your AI agent profile. * Use the **Test Call** feature to simulate an incoming call. * Trigger a transfer scenario (for example, the customer requests to speak to sales) to verify the correct number and message are used. *** ## Tips & Best Practices * **Create separate configurations for each department.**\ Example: *Sales*, *Support*, *Billing*, and *Customer Success*. Assign each to the corresponding AI agent. * **Use clear, consistent naming.**\ This helps you quickly identify configurations when managing multiple agents. * **Keep transfer messages short and professional.**\ Example: *“I’ll connect you with our support team now.”* Avoid long or repetitive phrasing. * **Update or delete configurations anytime.**\ You can modify them in **Call Transfer**, and changes will take effect once the associated agents are re-saved. *** ## Troubleshooting **Issue:** No gear icon next to Transfer Call\ **Cause:** No transfer configurations exist yet.\ **Fix:** Create one first in **Call Transfer**. **Issue:** Changes not saving\ **Cause:** Required fields are incomplete or unsaved.\ **Fix:** Fill all fields and click **Save** again. **Issue:** Calls not transferring correctly\ **Cause:** Invalid phone number format or wrong configuration selected.\ **Fix:** Ensure the phone number includes the international code and that the configuration shows as **Selected**. *** ## Summary Your AI agents can now route callers directly to the appropriate person or department without interruption. This setup improves efficiency, ensures consistent call handling, and provides a seamless experience for customers. # Anrufweiterleitung Source: https://support.callin.io/Create-AI-Agent/Call-Transfer-copied-1 Erfahre, wie du Anrufweiterleitungen in Callin.io konfigurierst, aktivierst und verwaltest, damit dein KI-Agent Kundinnen und Kunden mit dem richtigen Team verbindet. ## Überblick Anrufweiterleitungen ermöglichen es deinem KI-Assistenten, eingehende Anrufe nahtlos an die richtige Abteilung, das passende Team oder eine externe Nummer umzuleiten — ohne aufzulegen oder Verzögerungen zu verursachen. Diese Funktion sorgt für ein professionelles Kundenerlebnis und hilft deiner Organisation, Anrufe effizient zu verwalten. Du führst dieses Setup in zwei Hauptschritten durch: Du erstellst eine **Transfer-Konfiguration** und verknüpfst sie mit deinem **KI-Agenten**. *** ## Schritt 1: Eine Transfer-Konfiguration erstellen 1. **Die Seite „Call Transfer“ öffnen**\ Öffne in deinem Callin.io-Dashboard das linke Menü und wähle **Call Transfer**. * Wenn du das zum ersten Mal einrichtest, siehst du eine Meldung: **„No Call Transfer Configurations found.“** * Klicke auf **+ Create Configuration**, um zu beginnen. 2. **Den Bereich „Basic Information“ ausfüllen**\ Dieser Bereich hilft dabei, deine Weiterleitungsregeln zu identifizieren und zu organisieren. * **Title:** Der interne Name für diese Konfiguration (zum Beispiel *Sales LATAM* oder *Support Team*). * **Department:** Das Team oder die Gruppe, die für die übernommenen Anrufe zuständig ist. Beide Felder sind erforderlich. Wenn sie leer bleiben, erscheint ein roter Hinweis (z. B. *„Title is required!“*), der zur Eingabe auffordert. 3. **Transfer-Details hinzufügen**\ Lege fest, wohin der Anruf umgeleitet werden soll und was während des Weiterleitungsprozesses passiert. * Klicke auf **+ Add** und fülle diese Felder aus: * **Agent Name:** Dieses Feld ist standardmäßig vorausgefüllt und identifiziert den aktuellen KI-Agenten. * **Transfer Phone Number:** Die Telefonnummer, an die Anrufe weitergeleitet werden (zum Beispiel `+44 700123456`). * **Transfer Message:** Die kurze Nachricht, die dein KI-Agent vor der Weiterleitung sagt (zum Beispiel *„Ich verbinde Sie kurz mit unserer Vertriebsabteilung, einen Moment bitte.“*). Klicke auf **Save**, sobald du alle Felder ausgefüllt hast. Die Konfiguration erscheint anschließend in deiner **Call Transfer**-Liste. *** ## Schritt 2: Anrufweiterleitung für einen KI-Agenten aktivieren Sobald die Konfiguration bereit ist, kannst du sie für jeden deiner KI-Agenten aktivieren. 1. Gehe im Hauptmenü zu **AI Agents**. 2. Wähle den Agenten aus, für den du Anrufweiterleitungen aktivieren möchtest. 3. Öffne den Tab **Call Action** in den Agenten-Einstellungen. 4. Suche die Option **Transfer Call** und aktiviere sie. Der Schalter wird blau, um die Aktivierung anzuzeigen. 5. Klicke auf das ⚙️ **Zahnrad-Symbol** neben dem Schalter. Dadurch öffnet sich ein Konfigurationspanel mit allen verfügbaren Weiterleitungs-Setups. 6. Wähle die Konfiguration aus, die du gerade erstellt hast (zum Beispiel *Sales LATAM*). Nach der Auswahl wird sie in grünem Text als **Selected** angezeigt. Dieser Prozess verknüpft die Konfiguration mit deinem Agenten und bereitet sie für Live-Anrufe vor. *** ## Schritt 3: Setup speichern und testen Nachdem du die Weiterleitungsregel zugewiesen hast, scrolle in die rechte untere Ecke der Agenten-Seite und klicke auf **Save**. Wenn eine Meldung erscheint wie *„You have unsaved changes,“* wurde die Konfiguration noch nicht gespeichert — klicke erneut auf **Save**, um zu bestätigen. Sobald gespeichert, kann dein KI-Agent erkennen, wann ein Anruf umgeleitet werden soll, und die Weiterleitung in Echtzeit automatisch durchführen. ### Deine Konfiguration testen Um sicherzustellen, dass alles wie erwartet funktioniert: * Gehe zu deinem KI-Agentenprofil. * Nutze die Funktion **Test Call**, um einen eingehenden Anruf zu simulieren. * Löse ein Weiterleitungs-Szenario aus (zum Beispiel: Der Kunde möchte mit dem Vertrieb sprechen), um zu prüfen, ob die richtige Nummer und Nachricht verwendet werden. *** ## Tipps & Best Practices * **Erstelle separate Konfigurationen pro Abteilung.**\ Beispiel: *Sales*, *Support*, *Billing* und *Customer Success*. Weise jede Konfiguration dem entsprechenden KI-Agenten zu. * **Verwende klare, konsistente Namen.**\ So kannst du Konfigurationen schnell identifizieren, wenn du mehrere Agenten verwaltest. * **Halte Transfer-Nachrichten kurz und professionell.**\ Beispiel: *„Ich verbinde Sie jetzt mit unserem Support-Team.“* Vermeide lange oder repetitive Formulierungen. * **Aktualisiere oder lösche Konfigurationen jederzeit.**\ Du kannst sie unter **Call Transfer** anpassen. Änderungen greifen, sobald die zugehörigen Agenten erneut gespeichert werden. *** ## Fehlerbehebung **Problem:** Kein Zahnrad-Symbol neben „Transfer Call“\ **Ursache:** Es existieren noch keine Transfer-Konfigurationen.\ **Lösung:** Erstelle zuerst eine Konfiguration unter **Call Transfer**. **Problem:** Änderungen werden nicht gespeichert\ **Ursache:** Pflichtfelder sind unvollständig oder nicht gespeichert.\ **Lösung:** Fülle alle Felder aus und klicke erneut auf **Save**. **Problem:** Anrufe werden nicht korrekt weitergeleitet\ **Ursache:** Ungültiges Telefonnummernformat oder falsche Konfiguration ausgewählt.\ **Lösung:** Stelle sicher, dass die Telefonnummer den internationalen Ländercode enthält und dass die Konfiguration als **Selected** angezeigt wird. *** ## Zusammenfassung Deine KI-Agenten können Anrufende jetzt ohne Unterbrechung direkt zur passenden Person oder Abteilung weiterleiten. Dieses Setup verbessert die Effizienz, sorgt für eine konsistente Anrufbearbeitung und bietet Kundinnen und Kunden ein nahtloses Erlebnis. # Transferencia de llamada Source: https://support.callin.io/Create-AI-Agent/Call-Transfer-copied-2 Aprende a configurar, activar y gestionar transferencias de llamadas dentro de Callin.io para que tu agente de IA conecte a los clientes con el equipo adecuado. ## Resumen Las transferencias de llamadas permiten que tu asistente de IA redirija llamadas entrantes sin interrupciones al departamento, equipo o número externo correcto — sin colgar ni provocar retrasos. Esta función garantiza una experiencia profesional para el cliente y ayuda a tu organización a gestionar las llamadas de forma eficiente. Completarás esta configuración en dos pasos principales: crear una **configuración de transferencia** y vincularla a tu **agente de IA**. *** ## Paso 1: Crea una configuración de transferencia 1. **Abre la página de transferencia de llamadas**\ En tu panel de Callin.io, abre el menú lateral izquierdo y selecciona **Call Transfer**. * Si estás configurándolo por primera vez, verás un mensaje que dice **“No Call Transfer Configurations found.”** * Haz clic en **+ Create Configuration** para empezar. 2. **Completa la sección de información básica**\ Esta sección ayuda a identificar y organizar tus reglas de transferencia. * **Title:** El nombre interno de esta configuración (por ejemplo, *Ventas LATAM* o *Equipo de soporte*). * **Department:** El equipo o grupo responsable de gestionar las llamadas transferidas. Ambos campos son obligatorios. Si se dejan en blanco, aparecerá una alerta roja (por ejemplo, *“Title is required!”*) para solicitar que los completes. 3. **Añade los detalles de transferencia**\ Define a dónde debe redirigirse la llamada y qué ocurre durante el proceso de transferencia. * Haz clic en **+ Add** y completa estos campos: * **Agent Name:** Se completa automáticamente por defecto, identificando al agente de IA actual. * **Transfer Phone Number:** El número de teléfono al que se transferirán las llamadas (por ejemplo, `+44 700123456`). * **Transfer Message:** El mensaje breve que tu agente de IA dice antes de transferir la llamada (por ejemplo, *“Déjame conectarte con nuestro departamento de ventas, un momento por favor.”*). Haz clic en **Save** cuando hayas rellenado todos los campos. La configuración aparecerá ahora en tu lista de **Call Transfer**. *** ## Paso 2: Activa la transferencia de llamadas para un agente de IA Cuando la configuración esté lista, puedes activarla para cualquiera de tus agentes de IA. 1. Ve a **AI Agents** en el menú principal de navegación. 2. Selecciona el agente para el que quieres habilitar transferencias. 3. Abre la pestaña **Call Action** en los ajustes del agente. 4. Localiza la opción **Transfer Call** y actívala. El interruptor se pondrá azul para indicar que está activada. 5. Haz clic en el icono ⚙️ **gear** junto al interruptor. Esto abre un panel de configuración con todas las transferencias disponibles. 6. Selecciona la configuración que acabas de crear (por ejemplo, *Ventas LATAM*). Una vez seleccionada, aparecerá como **Selected** en texto verde. Este proceso vincula la configuración al agente y lo deja listo para usar en llamadas reales. *** ## Paso 3: Guarda y prueba la configuración Después de asignar la regla de transferencia, desplázate a la esquina inferior derecha de la página del agente y haz clic en **Save**. Si aparece un mensaje que dice *“You have unsaved changes,”* la configuración todavía no se ha guardado — vuelve a hacer clic en **Save** para confirmar. Una vez guardado, tu agente de IA ya puede detectar cuándo debe redirigirse una llamada y realizar la transferencia automáticamente en tiempo real. ### Prueba de tu configuración Para asegurarte de que todo funciona como esperas: * Ve al perfil de tu agente de IA. * Usa la función **Test Call** para simular una llamada entrante. * Dispara un escenario de transferencia (por ejemplo, el cliente pide hablar con ventas) para verificar que se usa el número y el mensaje correctos. *** ## Consejos y buenas prácticas * **Crea configuraciones separadas para cada departamento.**\ Ejemplo: *Ventas*, *Soporte*, *Facturación* y *Customer Success*. Asigna cada una al agente de IA correspondiente. * **Usa nombres claros y consistentes.**\ Esto te ayuda a identificar rápidamente configuraciones cuando gestionas varios agentes. * **Mantén los mensajes de transferencia cortos y profesionales.**\ Ejemplo: *“Te conecto ahora con nuestro equipo de soporte.”* Evita frases largas o repetitivas. * **Actualiza o elimina configuraciones en cualquier momento.**\ Puedes modificarlas en **Call Transfer**, y los cambios se aplicarán cuando vuelvas a guardar los agentes asociados. *** ## Solución de problemas **Problema:** No aparece el icono de engranaje junto a Transfer Call\ **Causa:** Todavía no existen configuraciones de transferencia.\ **Solución:** Crea una primero en **Call Transfer**. **Problema:** Los cambios no se guardan\ **Causa:** Faltan campos obligatorios o los cambios no se han guardado.\ **Solución:** Completa todos los campos y haz clic en **Save** otra vez. **Problema:** Las llamadas no se transfieren correctamente\ **Causa:** Formato de número inválido o se seleccionó la configuración equivocada.\ **Solución:** Asegúrate de que el número incluya el prefijo internacional y de que la configuración aparezca como **Selected**. *** ## Resumen Tus agentes de IA ya pueden enrutar a los llamantes directamente a la persona o departamento adecuado sin interrupciones. Esta configuración mejora la eficiencia, garantiza un manejo consistente de llamadas y ofrece una experiencia fluida para los clientes. # Trasferimento di chiamata Source: https://support.callin.io/Create-AI-Agent/Call-Transfer-copied-3 Scopri come configurare, attivare e gestire i trasferimenti di chiamata in Callin.io per garantire che il tuo agente AI metta in contatto i clienti con il team giusto. ## Panoramica I trasferimenti di chiamata permettono al tuo assistente AI di reindirizzare senza interruzioni le chiamate in arrivo verso il reparto, il team o un numero esterno corretto — senza riagganciare né causare ritardi. Questa funzionalità garantisce un’esperienza cliente professionale e aiuta la tua organizzazione a gestire le chiamate in modo efficiente. Completerai questa configurazione in due passaggi principali: creare una **configurazione di trasferimento** e collegarla al tuo **agente AI**. *** ## Passo 1: Crea una configurazione di trasferimento 1. **Apri la pagina di trasferimento chiamate**\ Nella dashboard di Callin.io, apri il menu a sinistra e seleziona **Call Transfer**. * Se lo stai configurando per la prima volta, vedrai un messaggio che dice **“Nessuna configurazione di trasferimento chiamate trovata.”** * Clicca **+ Create Configuration** per iniziare. 2. **Completa la sezione delle informazioni di base**\ Questa sezione aiuta a identificare e organizzare le regole di trasferimento. * **Title:** il nome interno di questa configurazione (ad esempio *Sales LATAM* o *Support Team*). * **Department:** il team o il gruppo responsabile della gestione delle chiamate trasferite. Entrambi i campi sono obbligatori. Se lasciati vuoti, apparirà un avviso rosso (ad esempio *“Title is required!”*) che ti chiederà di completare. 3. **Aggiungi i dettagli del trasferimento**\ Definisci dove deve essere reindirizzata la chiamata e cosa succede durante il processo di trasferimento. * Clicca **+ Add** e compila questi campi: * **Agent Name:** precompilato per impostazione predefinita, identifica l’agente AI corrente. * **Transfer Phone Number:** il numero verso cui verranno trasferite le chiamate (ad esempio `+44 700123456`). * **Transfer Message:** il breve messaggio che il tuo agente AI pronuncia prima del trasferimento (ad esempio *“Ti metto in contatto con il nostro reparto vendite, un momento per favore.”*). Clicca **Save** dopo aver compilato tutti i campi. La configurazione apparirà ora nella lista **Call Transfer**. *** ## Passo 2: Attiva il trasferimento chiamata per un agente AI Una volta pronta la configurazione, puoi attivarla per qualsiasi agente AI. 1. Vai su **AI Agents** nel menu di navigazione principale. 2. Seleziona l’agente per cui vuoi abilitare i trasferimenti. 3. Apri la scheda **Call Action** nelle impostazioni dell’agente. 4. Trova l’opzione **Transfer Call** e attivala. Il toggle diventerà blu per indicare l’attivazione. 5. Clicca sull’icona ⚙️ accanto al toggle. Si aprirà un pannello di configurazione con tutte le configurazioni di trasferimento disponibili. 6. Seleziona la configurazione che hai appena creato (ad esempio *Sales LATAM*). Una volta selezionata, apparirà come **Selected** in testo verde. Questo processo collega la configurazione al tuo agente e lo prepara all’uso nelle chiamate reali. *** ## Passo 3: Salva e testa la configurazione Dopo aver assegnato la regola di trasferimento, scorri nell’angolo in basso a destra della pagina dell’agente e clicca **Save**. Se appare un messaggio che dice *“You have unsaved changes,”* significa che la configurazione non è stata ancora salvata — clicca di nuovo **Save** per confermare. Una volta salvato, il tuo agente AI potrà rilevare quando una chiamata deve essere reindirizzata ed eseguire il trasferimento automaticamente in tempo reale. ### Test della configurazione Per verificare che tutto funzioni correttamente: * Vai al profilo del tuo agente AI. * Usa la funzione **Test Call** per simulare una chiamata in arrivo. * Attiva uno scenario di trasferimento (ad esempio, il cliente chiede di parlare con il reparto vendite) per verificare che vengano usati il numero e il messaggio corretti. *** ## Suggerimenti e buone pratiche * **Crea configurazioni separate per ogni reparto.**\ Esempio: *Sales*, *Support*, *Billing* e *Customer Success*. Assegna ciascuna configurazione all’agente AI corrispondente. * **Usa nomi chiari e coerenti.**\ Ti aiuta a identificare rapidamente le configurazioni quando gestisci più agenti. * **Mantieni i messaggi di trasferimento brevi e professionali.**\ Esempio: *“Ti metto in contatto con il nostro team di supporto.”* Evita frasi lunghe o ripetitive. * **Aggiorna o elimina le configurazioni in qualsiasi momento.**\ Puoi modificarle in **Call Transfer** e le modifiche avranno effetto una volta che gli agenti associati verranno salvati di nuovo. *** ## Risoluzione dei problemi **Problema:** Nessuna icona ⚙️ accanto a Transfer Call\ **Causa:** Non esistono ancora configurazioni di trasferimento.\ **Soluzione:** Creane una prima in **Call Transfer**. **Problema:** Le modifiche non vengono salvate\ **Causa:** Campi obbligatori incompleti o modifiche non salvate.\ **Soluzione:** Compila tutti i campi e clicca di nuovo **Save**. **Problema:** Le chiamate non vengono trasferite correttamente\ **Causa:** Formato del numero non valido o configurazione sbagliata selezionata.\ **Soluzione:** Assicurati che il numero includa il prefisso internazionale e che la configurazione risulti come **Selected**. *** ## Riepilogo I tuoi agenti AI ora possono indirizzare i chiamanti direttamente alla persona o al reparto corretto senza interruzioni. Questa configurazione migliora l’efficienza, garantisce una gestione coerente delle chiamate e offre un’esperienza fluida ai clienti. # Transfert d’appel Source: https://support.callin.io/Create-AI-Agent/Call-Transfer-copied-4 Apprenez à configurer, activer et gérer les transferts d’appels dans Callin.io afin que votre agent IA connecte vos clients à la bonne équipe. ## Vue d’ensemble Les transferts d’appels permettent à votre assistant IA de rediriger facilement les appels entrants vers le bon service, la bonne équipe ou un numéro externe — sans raccrocher et sans délai inutile. Cette fonctionnalité garantit une expérience client professionnelle et aide votre organisation à gérer les appels efficacement. Vous effectuerez la configuration en deux étapes principales : créer une **configuration de transfert** et la lier à votre **agent IA**. *** ## Étape 1 : Créer une configuration de transfert 1. **Ouvrir la page Call Transfer**\ Dans votre tableau de bord Callin.io, ouvrez le menu de gauche et sélectionnez **Call Transfer**. * Si c’est votre première configuration, vous verrez un message indiquant **« No Call Transfer Configurations found. »** * Cliquez sur **+ Create Configuration** pour commencer. 2. **Compléter la section des informations de base**\ Cette section permet d’identifier et d’organiser vos règles de transfert. * **Title :** le nom interne de cette configuration (par exemple *Sales LATAM* ou *Support Team*). * **Department :** l’équipe ou le groupe responsable de traiter les appels transférés. Les deux champs sont obligatoires. S’ils sont vides, une alerte rouge (par exemple *« Title is required! »*) s’affichera pour vous demander de les compléter. 3. **Ajouter les détails du transfert**\ Définissez vers où l’appel doit être redirigé et ce qui se passe pendant le transfert. * Cliquez sur **+ Add** et renseignez ces champs : * **Agent Name :** pré-rempli par défaut, il identifie l’agent IA actuel. * **Transfer Phone Number :** le numéro vers lequel les appels seront transférés (par exemple `+44 700123456`). * **Transfer Message :** le court message que votre agent IA prononce avant de transférer l’appel (par exemple *« Je vous mets en relation avec notre service commercial, un instant s’il vous plaît. »*). Cliquez sur **Save** une fois tous les champs remplis. La configuration apparaîtra alors dans votre liste **Call Transfer**. *** ## Étape 2 : Activer le transfert d’appel pour un agent IA Une fois la configuration prête, vous pouvez l’activer pour n’importe lequel de vos agents IA. 1. Allez dans **AI Agents** dans le menu principal. 2. Sélectionnez l’agent pour lequel vous souhaitez activer les transferts. 3. Ouvrez l’onglet **Call Action** dans les paramètres de l’agent. 4. Repérez l’option **Transfer Call** et activez-la. Le bouton bascule devient bleu pour indiquer l’activation. 5. Cliquez sur l’icône ⚙️ **engrenage** à côté du bouton. Cela ouvre un panneau listant toutes les configurations de transfert disponibles. 6. Sélectionnez la configuration que vous venez de créer (par exemple *Sales LATAM*). Une fois sélectionnée, elle apparaîtra comme **Selected** en vert. Ce processus lie la configuration à votre agent et la prépare pour une utilisation en appels réels. *** ## Étape 3 : Enregistrer et tester la configuration Après avoir assigné la règle de transfert, faites défiler jusqu’en bas à droite de la page de l’agent et cliquez sur **Save**. Si un message indique *« You have unsaved changes »*, cela signifie que la configuration n’a pas encore été enregistrée — cliquez à nouveau sur **Save** pour confirmer. Une fois enregistré, votre agent IA peut détecter quand un appel doit être redirigé et effectuer le transfert automatiquement en temps réel. ### Tester votre configuration Pour vérifier que tout fonctionne : * Allez sur le profil de votre agent IA. * Utilisez la fonctionnalité **Test Call** pour simuler un appel entrant. * Déclenchez un scénario de transfert (par exemple le client demande à parler au service commercial) pour vérifier que le bon numéro et le bon message sont utilisés. *** ## Conseils et bonnes pratiques * **Créez des configurations distinctes pour chaque service.**\ Exemple : *Sales*, *Support*, *Billing* et *Customer Success*. Assignez chacune à l’agent IA correspondant. * **Utilisez un nommage clair et cohérent.**\ Cela vous aide à identifier rapidement les configurations lorsque vous gérez plusieurs agents. * **Gardez les messages de transfert courts et professionnels.**\ Exemple : *« Je vous mets en relation avec notre équipe support. »* Évitez les formulations longues ou répétitives. * **Modifiez ou supprimez les configurations à tout moment.**\ Vous pouvez les ajuster dans **Call Transfer**, et les changements s’appliqueront dès que les agents associés seront enregistrés à nouveau. *** ## Dépannage **Problème :** pas d’icône d’engrenage à côté de Transfer Call\ **Cause :** aucune configuration de transfert n’existe encore.\ **Solution :** créez d’abord une configuration dans **Call Transfer**. **Problème :** les modifications ne s’enregistrent pas\ **Cause :** des champs obligatoires sont incomplets ou non enregistrés.\ **Solution :** remplissez tous les champs puis cliquez à nouveau sur **Save**. **Problème :** les appels ne sont pas transférés correctement\ **Cause :** format de numéro invalide ou mauvaise configuration sélectionnée.\ **Solution :** vérifiez que le numéro inclut l’indicatif international et que la configuration apparaît comme **Selected**. *** ## Résumé Vos agents IA peuvent désormais acheminer les appelants vers la personne ou le service approprié, sans interruption. Cette configuration améliore l’efficacité, garantit un traitement cohérent des appels et offre une expérience fluide aux clients. # Campaigns Source: https://support.callin.io/Create-AI-Agent/Campaign Create outbound calling campaigns, select contacts, choose when to launch, and track results with Campaigns Analytics. ## Overview The **Campaigns** section is where you set up and run outbound calling campaigns, then track how they performed. From here you can: * Create a campaign with an **AI Agent** * Select contacts (or upload a CSV inside the campaign flow) * Launch immediately or schedule for later * Monitor progress and outcomes * Review performance in **Campaigns Analytics** To open Campaigns directly: [Click here to go to Campaigns](https://app.callin.io/campaigns?activeTab=campaigns\&view=list)Screenshot: Your campaigns list, where you can filter, create new campaigns, and open a campaign to view details.
## Create a campaign Click **Create Campaign** to open the campaign setup panel. ### 1) Basic information Fill in: * **Campaign Name** (required) * **AI Agent** (required) > **Important:** The UI warns that the agent should have a number assigned during campaign execution. If the agent can’t place calls, the campaign won’t work properly. ### 2) Select contacts In **Select Contacts**, you can: * Search contacts using **Search contacts…** * Narrow the list with **Filters** * Select one or multiple contacts using the checkboxes * Navigate large lists using pagination * Use **Upload CSV** if you want to bring contacts into this campaign from a file > **Tip:** If your contacts are already in a spreadsheet, export them as a **.csv** file before uploading. ### 3) Map columns (when uploading CSV) If you upload a CSV, you’ll be asked to map columns before continuing. Typical fields include: * **Phone** (required) * **Name** (optional) * **Email** (optional) > **Common mistake:** Not mapping **Phone**. The campaign can’t add contacts without a phone number. ### 4) Launch options Under **Launch Options**, choose how and when the campaign runs: * **Launch Now**: starts immediately. * **Schedule for Later**: lets you set: * **Start Time** * **End Time** * **Timezone** You can also enable **Follow-up Calls** to automatically retry calls for contacts who didn’t answer or were busy. > **Important:** Follow-up behavior can vary by workspace settings. If you’re not sure how retries work in your account, run a small test campaign first. ## Manage campaigns ### Filter and find campaigns Use the filter bar to narrow down what you see, for example: * Search by **Campaign ID or Name** * Filter by **Status** * Limit results by **Date Range** * Toggle **Show Deleted** to view deleted campaigns (if available in your account) ### View campaign details Click **View** on a campaign card to open its details. Inside, you can typically see: * Campaign progress * Counters (e.g., in progress, busy, no answer, completed, failed) * A contact-level table with statuses and outcomes * A **Refresh** option to update results ### Delete a campaign (permanent) Campaign cards may include a delete (trash) icon. When you delete a campaign: * You’ll see a confirmation modal * You may be required to type **DELETE** to confirm > **Important:** Deleting a campaign is a **permanent action** and cannot be undone. ## Campaigns Analytics Switch to **Campaigns Analytics** to understand how campaigns performed over time. ### What you can review In the analytics overview, you can typically review metrics like: * Total calls * Average call duration * Usage * Appointments * Detection and success rates * Trends and breakdowns (volume over time, outcomes, key metrics)Screenshot: Campaigns Analytics overview, where you can review performance metrics and trends.
# Kampagnen Source: https://support.callin.io/Create-AI-Agent/Campaign-copied-1 Erstellen Sie Outbound-Kampagnen, wählen Sie Kontakte aus, entscheiden Sie den Startzeitpunkt und verfolgen Sie Ergebnisse mit Campaigns Analytics. ## Überblick Der Bereich **Campaigns** ist der Ort, an dem Sie Outbound-Kampagnen einrichten und ausführen und anschließend die Performance auswerten. Von hier aus können Sie: * Eine Kampagne mit einem **AI Agent** erstellen * Kontakte auswählen (oder während des Kampagnen-Flows eine CSV hochladen) * Sofort starten oder für später planen * Fortschritt und Ergebnisse verfolgen * Die Performance in **Campaigns Analytics** auswerten Um Campaigns direkt zu öffnen: [Klicken Sie hier, um zu Campaigns zu gehen](https://app.callin.io/campaigns?activeTab=campaigns\&view=list)Screenshot: Ihre Kampagnenliste – mit Filtern, der Möglichkeit neue Kampagnen zu erstellen und Kampagnen-Details zu öffnen.
## Eine Kampagne erstellen Klicken Sie auf **Create Campaign**, um das Setup-Panel zu öffnen. ### 1) Grundinformationen Füllen Sie aus: * **Campaign Name** (erforderlich) * **AI Agent** (erforderlich) > **Wichtig:** Die Oberfläche zeigt einen Hinweis: Der Agent sollte während der Kampagnen-Ausführung eine Nummer zugewiesen haben. Wenn der Agent keine Anrufe platzieren kann, funktioniert die Kampagne nicht korrekt. ### 2) Kontakte auswählen Unter **Select Contacts** können Sie: * Kontakte mit **Search contacts…** suchen * Die Liste mit **Filters** eingrenzen * Einen oder mehrere Kontakte per Checkbox auswählen * Große Listen über die Pagination durchblättern * **Upload CSV** verwenden, wenn Sie Kontakte aus einer Datei zu dieser Kampagne hinzufügen möchten > **Tipp:** Wenn Ihre Kontakte bereits in einer Tabelle sind, exportieren Sie sie als **.csv** Datei, bevor Sie sie hochladen. ### 3) Spalten zuordnen (bei CSV-Upload) Wenn Sie eine CSV hochladen, müssen Sie vor dem Fortfahren Spalten zuordnen. Typische Felder sind: * **Phone** (erforderlich) * **Name** (optional) * **Email** (optional) > **Häufiger Fehler:** **Phone** nicht zuordnen. Die Kampagne kann ohne Telefonnummer keine Kontakte hinzufügen. ### 4) Startoptionen Unter **Launch Options** wählen Sie, wie und wann die Kampagne läuft: * **Launch Now**: startet sofort. * **Schedule for Later**: hier können Sie festlegen: * **Start Time** * **End Time** * **Timezone** Zusätzlich können Sie **Follow-up Calls** aktivieren, um Kontakte automatisch erneut anzurufen, wenn sie nicht geantwortet haben oder besetzt waren. > **Wichtig:** Das Verhalten der Follow-ups kann je nach Workspace-Einstellungen variieren. Wenn Sie nicht sicher sind, wie Retries in Ihrem Account funktionieren, starten Sie zunächst eine kleine Testkampagne. ## Kampagnen verwalten ### Kampagnen filtern und finden Nutzen Sie die Filterleiste, um die Ansicht einzugrenzen, zum Beispiel: * Suchen nach **Campaign ID or Name** * Filtern nach **Status** * Eingrenzen über **Date Range** * **Show Deleted** aktivieren, um gelöschte Kampagnen anzuzeigen (falls in Ihrem Account verfügbar) ### Kampagnen-Details ansehen Klicken Sie auf **View** auf einer Kampagnen-Karte, um die Details zu öffnen. Dort sehen Sie typischerweise: * Kampagnenfortschritt * Zähler (z. B. in Bearbeitung, besetzt, keine Antwort, abgeschlossen, fehlgeschlagen) * Eine Kontakt-Tabelle mit Status und Outcome * Eine **Refresh**-Option, um Ergebnisse zu aktualisieren ### Eine Kampagne löschen (permanent) Kampagnen-Karten können ein Löschen-Symbol (Papierkorb) haben. Beim Löschen einer Kampagne: * Erscheint ein Bestätigungsdialog * Möglicherweise müssen Sie **DELETE** eingeben, um zu bestätigen > **Wichtig:** Das Löschen einer Kampagne ist **permanent** und kann nicht rückgängig gemacht werden. ## Campaigns Analytics Wechseln Sie zu **Campaigns Analytics**, um zu verstehen, wie Kampagnen im Zeitverlauf performt haben. ### Was Sie auswerten können In der Analytics-Übersicht können Sie typischerweise Metriken wie diese prüfen: * Gesamtanzahl Anrufe * Durchschnittliche Anrufdauer * Nutzung * Termine * Detection- und Erfolgsraten * Trends und Aufschlüsselungen (Volumen über die Zeit, Outcomes, Key Metrics)Screenshot: Campaigns Analytics Übersicht, um Performance-Kennzahlen und Trends auszuwerten.
# Campañas Source: https://support.callin.io/Create-AI-Agent/Campaign-copied-2 Crea campañas de llamadas salientes, selecciona contactos, elige cuándo lanzarlas y revisa resultados con Campaigns Analytics. ## Descripción general La sección **Campaigns** es donde configuras y ejecutas campañas de llamadas salientes, y después revisas su rendimiento. Desde aquí puedes: * Crear una campaña con un **AI Agent** * Seleccionar contactos (o subir un CSV dentro del flujo de campaña) * Lanzar al instante o programar para más tarde * Monitorizar el progreso y los resultados * Revisar el rendimiento en **Campaigns Analytics** Para abrir Campaigns directamente: [Haz clic aquí para ir a Campaigns](https://app.callin.io/campaigns?activeTab=campaigns\&view=list)Captura: Tu lista de campañas, donde puedes filtrar, crear campañas nuevas y abrir una campaña para ver detalles.
## Crear una campaña Haz clic en **Create Campaign** para abrir el panel de configuración de la campaña. ### 1) Información básica Rellena: * **Campaign Name** (obligatorio) * **AI Agent** (obligatorio) > **Importante:** La interfaz avisa de que el agente debería tener un número asignado durante la ejecución de la campaña. Si el agente no puede hacer llamadas, la campaña no funcionará correctamente. ### 2) Seleccionar contactos En **Select Contacts**, puedes: * Buscar contactos con **Search contacts…** * Acotar la lista con **Filters** * Seleccionar uno o varios contactos con las casillas * Navegar listas grandes con la paginación * Usar **Upload CSV** si quieres traer contactos a esta campaña desde un archivo > **Consejo:** Si tus contactos ya están en una hoja de cálculo, expórtalos como archivo **.csv** antes de subirlos. ### 3) Mapear columnas (al subir CSV) Si subes un CSV, se te pedirá mapear columnas antes de continuar. Los campos típicos incluyen: * **Phone** (obligatorio) * **Name** (opcional) * **Email** (opcional) > **Error común:** No mapear **Phone**. La campaña no puede añadir contactos sin un número de teléfono. ### 4) Opciones de lanzamiento En **Launch Options**, elige cómo y cuándo se ejecuta la campaña: * **Launch Now**: empieza inmediatamente. * **Schedule for Later**: te permite definir: * **Start Time** * **End Time** * **Timezone** También puedes activar **Follow-up Calls** para reintentar automáticamente llamadas a contactos que no respondieron o estaban ocupados. > **Importante:** El comportamiento de los reintentos puede variar según la configuración de tu workspace. Si no tienes claro cómo funcionan en tu cuenta, empieza con una campaña de prueba pequeña. ## Gestionar campañas ### Filtrar y encontrar campañas Usa la barra de filtros para acotar lo que ves, por ejemplo: * Buscar por **Campaign ID or Name** * Filtrar por **Status** * Limitar por **Date Range** * Activar **Show Deleted** para ver campañas eliminadas (si está disponible en tu cuenta) ### Ver detalles de una campaña Haz clic en **View** en una tarjeta de campaña para abrir sus detalles. Dentro, normalmente puedes ver: * Progreso de la campaña * Contadores (por ejemplo, en progreso, ocupado, no responde, completado, fallido) * Una tabla por contacto con estados y resultados * Una opción **Refresh** para actualizar resultados ### Eliminar una campaña (permanente) Las tarjetas de campaña pueden incluir un icono de eliminar (papelera). Al eliminar una campaña: * Verás un modal de confirmación * Puede que tengas que escribir **DELETE** para confirmar > **Importante:** Eliminar una campaña es una acción **permanente** y no se puede deshacer. ## Campaigns Analytics Cambia a **Campaigns Analytics** para entender cómo han rendido las campañas a lo largo del tiempo. ### Qué puedes revisar En el overview de analíticas, normalmente puedes revisar métricas como: * Total de llamadas * Duración media de llamada * Uso * Citas * Tasas de detección y éxito * Tendencias y desgloses (volumen en el tiempo, resultados, métricas clave)Captura: Overview de Campaigns Analytics, donde puedes revisar métricas de rendimiento y tendencias.
# Campagne Source: https://support.callin.io/Create-AI-Agent/Campaign-copied-3 Crea campagne di chiamate in uscita, seleziona contatti, scegli quando lanciarle e monitora i risultati con Campaigns Analytics. ## Panoramica La sezione **Campaigns** è dove configuri ed esegui campagne di chiamate in uscita e poi analizzi come sono andate. Da qui puoi: * Creare una campagna con un **AI Agent** * Selezionare contatti (o caricare un CSV durante il flusso di creazione della campagna) * Avviare subito o pianificare per dopo * Monitorare avanzamento e risultati * Analizzare le performance in **Campaigns Analytics** Per aprire Campaigns direttamente: [Clicca qui per andare a Campaigns](https://app.callin.io/campaigns?activeTab=campaigns\&view=list)Screenshot: La lista delle campagne, dove puoi filtrare, creare una nuova campagna e aprire una campagna per vedere i dettagli.
## Creare una campagna Clicca **Create Campaign** per aprire il pannello di configurazione della campagna. ### 1) Informazioni di base Compila: * **Campaign Name** (obbligatorio) * **AI Agent** (obbligatorio) > **Importante:** L’interfaccia mostra un avviso: l’agente deve avere un numero assegnato durante l’esecuzione della campagna. Se l’agente non riesce a effettuare chiamate, la campagna non funzionerà correttamente. ### 2) Selezionare i contatti In **Select Contacts** puoi: * Cercare contatti con **Search contacts…** * Restringere l’elenco con **Filters** * Selezionare uno o più contatti con le checkbox * Scorrere elenchi grandi con la paginazione * Usare **Upload CSV** se vuoi aggiungere contatti a questa campagna da un file > **Consiglio:** Se i contatti sono già in un foglio di calcolo, esportali come file **.csv** prima di caricarli. ### 3) Mappare le colonne (quando carichi un CSV) Se carichi un CSV, ti verrà chiesto di mappare le colonne prima di continuare. I campi tipici includono: * **Phone** (obbligatorio) * **Name** (opzionale) * **Email** (opzionale) > **Errore comune:** Non mappare **Phone**. La campagna non può aggiungere contatti senza un numero di telefono. ### 4) Opzioni di avvio In **Launch Options**, scegli come e quando viene eseguita la campagna: * **Launch Now**: parte immediatamente. * **Schedule for Later**: ti permette di impostare: * **Start Time** * **End Time** * **Timezone** Puoi anche attivare **Follow-up Calls** per richiamare automaticamente i contatti che non hanno risposto o erano occupati. > **Importante:** Il comportamento dei richiami può variare in base alle impostazioni del tuo workspace. Se non sei sicuro di come funzionano i retry nel tuo account, avvia prima una piccola campagna di test. ## Gestire le campagne ### Filtrare e trovare le campagne Usa la barra dei filtri per restringere ciò che vedi, ad esempio: * Cercare per **Campaign ID or Name** * Filtrare per **Status** * Limitare per **Date Range** * Attivare **Show Deleted** per vedere le campagne eliminate (se disponibile nel tuo account) ### Visualizzare i dettagli di una campagna Clicca **View** su una scheda campagna per aprire i dettagli. In genere puoi vedere: * Avanzamento della campagna * Contatori (ad esempio, in corso, occupato, nessuna risposta, completato, fallito) * Una tabella per contatto con stato e risultato * Un’opzione **Refresh** per aggiornare i risultati ### Eliminare una campagna (permanent) Le schede campagna possono includere un’icona di eliminazione (cestino). Quando elimini una campagna: * Vedrai una finestra di conferma * Potrebbe essere necessario digitare **DELETE** per confermare > **Importante:** Eliminare una campagna è un’azione **permanente** e non può essere annullata. ## Campaigns Analytics Passa a **Campaigns Analytics** per capire come stanno andando le campagne nel tempo. ### Cosa puoi analizzare Nell’overview delle analytics, in genere puoi vedere metriche come: * Totale chiamate * Durata media chiamata * Utilizzo * Appuntamenti * Tassi di detection e di successo * Trend e breakdown (volume nel tempo, esiti, metriche chiave)Screenshot: Overview di Campaigns Analytics, per consultare metriche di performance e trend.
# Campagnes Source: https://support.callin.io/Create-AI-Agent/Campaign-copied-4 Créez des campagnes d’appels sortants, sélectionnez des contacts, choisissez quand les lancer et suivez les résultats avec Campaigns Analytics. ## Aperçu La section **Campaigns** est l’endroit où vous configurez et exécutez des campagnes d’appels sortants, puis où vous analysez leurs performances. Depuis ici, vous pouvez : * Créer une campagne avec un **AI Agent** * Sélectionner des contacts (ou téléverser un CSV pendant la création de la campagne) * Lancer immédiatement ou planifier pour plus tard * Suivre la progression et les résultats * Analyser les performances dans **Campaigns Analytics** Pour ouvrir Campaigns directement : [Cliquez ici pour aller à Campaigns](https://app.callin.io/campaigns?activeTab=campaigns\&view=list)Capture : Votre liste de campagnes, avec la possibilité de filtrer, créer une campagne et ouvrir une campagne pour voir ses détails.
## Créer une campagne Cliquez sur **Create Campaign** pour ouvrir le panneau de configuration de la campagne. ### 1) Informations de base Renseignez : * **Campaign Name** (obligatoire) * **AI Agent** (obligatoire) > **Important :** L’interface affiche un avertissement indiquant que l’agent doit avoir un numéro attribué pendant l’exécution de la campagne. Si l’agent ne peut pas passer d’appels, la campagne ne fonctionnera pas correctement. ### 2) Sélectionner des contacts Dans **Select Contacts**, vous pouvez : * Rechercher des contacts avec **Search contacts…** * Affiner la liste avec **Filters** * Sélectionner un ou plusieurs contacts avec les cases à cocher * Parcourir de grandes listes via la pagination * Utiliser **Upload CSV** si vous souhaitez ajouter des contacts à cette campagne depuis un fichier > **Astuce :** Si vos contacts sont déjà dans un tableur, exportez-les en fichier **.csv** avant de les téléverser. ### 3) Mapper les colonnes (lors d’un téléversement CSV) Si vous téléversez un CSV, vous devrez mapper les colonnes avant de continuer. Les champs typiques sont : * **Phone** (obligatoire) * **Name** (facultatif) * **Email** (facultatif) > **Erreur fréquente :** Ne pas mapper **Phone**. La campagne ne peut pas ajouter de contacts sans numéro de téléphone. ### 4) Options de lancement Sous **Launch Options**, choisissez comment et quand la campagne s’exécute : * **Launch Now** : démarre immédiatement. * **Schedule for Later** : vous permet de définir : * **Start Time** * **End Time** * **Timezone** Vous pouvez aussi activer **Follow-up Calls** pour relancer automatiquement les contacts qui n’ont pas répondu ou qui étaient occupés. > **Important :** Le comportement des relances peut varier selon les paramètres de votre workspace. Si vous n’êtes pas sûr de la logique de relance sur votre compte, lancez d’abord une petite campagne de test. ## Gérer les campagnes ### Filtrer et retrouver des campagnes Utilisez la barre de filtres pour réduire ce que vous voyez, par exemple : * Rechercher par **Campaign ID or Name** * Filtrer par **Status** * Limiter par **Date Range** * Activer **Show Deleted** pour afficher les campagnes supprimées (si disponible sur votre compte) ### Voir les détails d’une campagne Cliquez sur **View** sur une carte de campagne pour ouvrir ses détails. À l’intérieur, vous pouvez généralement voir : * La progression de la campagne * Des compteurs (par exemple, en cours, occupé, pas de réponse, terminé, échec) * Un tableau par contact avec le statut et le résultat * Une option **Refresh** pour mettre à jour les résultats ### Supprimer une campagne (permanent) Les cartes de campagne peuvent inclure une icône de suppression (corbeille). Quand vous supprimez une campagne : * Un modal de confirmation s’affiche * Vous devrez peut-être taper **DELETE** pour confirmer > **Important :** Supprimer une campagne est une action **permanente** et ne peut pas être annulée. ## Campaigns Analytics Passez à **Campaigns Analytics** pour comprendre les performances des campagnes dans le temps. ### Ce que vous pouvez analyser Dans l’aperçu des analytics, vous pouvez généralement consulter des métriques comme : * Total des appels * Durée moyenne d’appel * Utilisation * Rendez-vous * Taux de détection et de succès * Tendances et répartitions (volume dans le temps, résultats, métriques clés)Capture : Aperçu de Campaigns Analytics, pour consulter les métriques de performance et les tendances.
# Voices Source: https://support.callin.io/Create-AI-Agent/Clone-Voice Browse and preview all available AI voices, assign a voice to an agent, or clone a voice for a custom sound. ## Open the Voices page The **Voices** section is where you manage how your agents sound. From here, you can: * Browse the **Voice Library** (ready-to-use voices) * **Preview** voices before using them * **Assign** a voice to a specific agent * **Clone a voice** (so your agent can speak with a custom voice) Go to the **Voices** section by clicking here: [Voices](https://app.callin.io/voices)Screenshot: The Voices page where you can preview voices in the library and switch to the Clone Voice tab to create a custom voice.
## Browse and preview voices (Try Voices) By default, you’ll land on **Try Voices**. This is the **Voice Library**, where each row includes: * A **Play** button to preview the voice * The **voice name** plus a short style description (for example: “laid-back”, “reassuring”, “energetic”) * **Details tags** like gender, language, and accent (for example: **Male**, **en**, **american**) * An **Assign** action on the right to use that voice with an agent You can also narrow down the list using: * The **search bar** (search by name or accent) * Filters such as **gender** and other available dropdowns (options can vary by account/plan) > **Tip:** When previewing voices, use the same short script each time so it’s easy to compare. > > Example: “Hi! This is Maya from Lakeside Dental. I’m calling to confirm your appointment for Thursday at 3 PM.” ## Assign a voice to an agent To make an agent speak with a specific voice: 1. In **Try Voices**, find the voice you want. 2. Click **Assign** on the right side of that voice. 3. In the **Assign Voice to Agent** window, select the agent you want to update. 4. Click **Assign** to confirm. After you assign it, that agent will use the selected voice when speaking on calls. > **Important:** You can change a voice later by assigning a different one. Voice assignment is typically set per agent (not global). ## Clone a voice (Clone Voice) If you want a more custom sound (for a brand voice or a specific persona), use **Clone Voice**. 1. Open the **Clone Voice** tab. 2. Click **Clone Voice**. 3. In the form (shown as a “Voice Preview” window), fill in: * **Voice Name** (required) * **Description** (optional) * **Language** (required) * **Gender** (required) 4. Add a **Voice Sample** (required) using one of the options shown: * **Upload Audio** * **Record Voice** 5. Follow the on-screen steps to submit your sample. Once your cloned voice is created, it will appear under **Your Cloned Voices** and can be assigned like any other voice. > **Common mistake:** Uploading a clip that’s too short or has background noise. Your clone will sound noticeably worse if the sample isn’t clean. ## Voice cloning guidelines and best practices When recording or uploading your sample, follow these guidelines: * Record in a **quiet environment** with minimal background noise * **Speak clearly** at a natural pace * For uploaded files, provide **at least 30 seconds** of continuous speech * Maximum file size is **4MB** * Supported languages include: **English, Italian, French, German, Portuguese, Spanish, Dutch, Arabic, and Hindi** > **Important:** Only upload audio you have permission to use (for example, your own voice or a voice you’re licensed to use). # Stimmen Source: https://support.callin.io/Create-AI-Agent/Clone-Voice-copied-1 Durchsuche und teste alle verfügbaren KI-Stimmen, weise eine Stimme einem Agenten zu oder klone eine Stimme für einen individuellen Klang. ## Die Seite „Stimmen“ öffnen In der Sektion **Stimmen** verwaltest du, wie deine Agenten klingen. Von hier aus kannst du: * Die **Stimmenbibliothek** durchsuchen (sofort nutzbare Stimmen) * Stimmen **vorher anhören**, bevor du dich entscheidest * Eine Stimme **einem Agenten zuweisen** * Eine Stimme **klonen**, um eine personalisierte Stimme zu erstellen Gehe zur Sektion **Stimmen**, indem du hier klickst: [Stimmen](https://app.callin.io/voices)Screenshot: Die Seite Stimmen, auf der du Stimmen anhören und den Bereich zum Klonen von Stimmen öffnen kannst.
## Stimmen durchsuchen und anhören Wenn du diese Seite öffnest, siehst du die **Stimmenbibliothek**. In der Regel enthält jede Zeile: * Eine **Wiedergabe-Schaltfläche**, um eine Hörprobe abzuspielen * Den **Stimmnamen** plus eine kurze Stilbeschreibung (z. B. ruhig, beruhigend, energiegeladen) * **Informations-Tags** wie Geschlecht, Sprache und Akzent * Eine Aktion rechts, um die Stimme **einem Agenten zuzuweisen** Um schneller die passende Stimme zu finden, kannst du nutzen: * Die **Suchleiste** (Suche nach Name oder Akzent) * Filter wie **Geschlecht** und weitere Auswahllisten (Optionen können je nach Konto/Plan variieren) > **Tipp:** Nutze beim Vergleichen immer denselben kurzen Beispieltext, damit du Stimmen leichter beurteilen kannst. > > Beispiel: „Hallo! Ich bin Maya von NovaDent. Ich rufe an, um Ihren Termin am Donnerstag um 15:00 Uhr zu bestätigen.“ ## Eine Stimme einem Agenten zuweisen Damit ein Agent mit einer bestimmten Stimme spricht: 1. Suche in der Stimmenbibliothek die gewünschte Stimme. 2. Nutze die Aktion rechts, um sie **zuzuweisen**. 3. Wähle im Zuweisungsfenster den Agenten aus, den du aktualisieren möchtest. 4. Bestätige, um die Änderung zu speichern. Nach der Zuweisung verwendet der Agent die ausgewählte Stimme bei Anrufen. > **Wichtig:** Du kannst die Stimme später jederzeit ändern, indem du eine andere Stimme zuweist. In der Regel wird die Stimme pro Agent festgelegt. ## Eine Stimme klonen Wenn du einen individuelleren Klang möchtest (z. B. für eine Markenstimme oder eine bestimmte Persona), kannst du in dieser Sektion eine Stimme klonen. 1. Öffne den Bereich zum Klonen von Stimmen. 2. Klicke auf die Schaltfläche, um eine neue geklonte Stimme zu erstellen. 3. Fülle das Formular aus: * **Stimmenname** (erforderlich) * **Beschreibung** (optional) * **Sprache** (erforderlich) * **Geschlecht** (erforderlich) 4. Füge ein **Stimmbeispiel** hinzu (erforderlich), indem du: * Eine Audiodatei hochlädst oder * Deine Stimme aufnimmst 5. Folge den Schritten auf dem Bildschirm, um das Beispiel zu senden. Nach der Erstellung erscheint die geklonte Stimme in deiner Liste geklonter Stimmen und kann wie jede andere Stimme zugewiesen werden. > **Häufiger Fehler:** Ein zu kurzes Beispiel oder eine Aufnahme mit Hintergrundgeräuschen. Eine saubere Aufnahme verbessert das Ergebnis deutlich. ## Richtlinien und Best Practices zum Klonen Wenn du dein Stimmbeispiel aufnimmst oder hochlädst, beachte Folgendes: * Nimm in einer **ruhigen Umgebung** mit möglichst wenig Hintergrundgeräuschen auf * **Sprich deutlich** in einem natürlichen Tempo * Wenn du eine Datei hochlädst, liefere **mindestens 30 Sekunden** zusammenhängende Sprache * Maximale Dateigröße: **4 MB** * Unterstützte Sprachen umfassen: **Englisch, Italienisch, Französisch, Deutsch, Portugiesisch, Spanisch, Niederländisch, Arabisch und Hindi** > **Wichtig:** Lade nur Audio hoch, das du verwenden darfst (z. B. deine eigene Stimme oder eine Stimme, für die du eine Lizenz hast). # Voces Source: https://support.callin.io/Create-AI-Agent/Clone-Voice-copied-2 Explora y prueba todas las voces de IA disponibles, asigna una voz a un agente o clona una voz para crear un sonido personalizado. ## Abrir la página de Voces La sección **Voces** es donde gestionas cómo suenan tus agentes. Desde aquí puedes: * Explorar la **biblioteca de voces** (voces listas para usar) * **Probar** voces antes de utilizarlas * **Asignar** una voz a un agente específico * **Clonar una voz** (para que tu agente hable con una voz personalizada) Ve a la sección **Voces** desde aquí: [Voces](https://app.callin.io/voices)Captura: La página de Voces donde puedes probar voces de la biblioteca y cambiar a la pestaña de clonación para crear una voz personalizada.
## Explorar y probar voces (biblioteca) Por defecto, entrarás en la pestaña para **probar voces**. Esta es la **biblioteca de voces**, donde cada fila incluye: * Un botón de **reproducción** para escuchar una muestra de la voz * El **nombre de la voz** y una breve descripción de estilo (por ejemplo: relajada, tranquilizadora, enérgica) * **Etiquetas de detalles** como género, idioma y acento * Una acción para **asignar** a la derecha y usar esa voz con un agente También puedes acotar la lista con: * La **barra de búsqueda** (buscar por nombre o acento) * Filtros como **género** y otros desplegables disponibles (las opciones pueden variar según tu cuenta o plan) > **Consejo:** Al probar voces, usa siempre el mismo guion corto para que sea fácil compararlas. > > Ejemplo: “¡Hola! Soy Maya de Lakeside Dental. Llamo para confirmar tu cita del jueves a las 3:00 p. m.” ## Asignar una voz a un agente Para que un agente hable con una voz específica: 1. En la biblioteca, encuentra la voz que quieres. 2. Pulsa la acción para **asignar** a la derecha de esa voz. 3. En la ventana para asignar la voz a un agente, selecciona el agente que quieres actualizar. 4. Confirma la asignación para guardar el cambio. Después de asignarla, ese agente usará la voz seleccionada cuando hable en las llamadas. > **Importante:** Puedes cambiar una voz más adelante asignando otra distinta. Normalmente, la asignación de voz se configura por agente (no de forma global). ## Clonar una voz (clonación) Si quieres un sonido más personalizado (para una voz de marca o un personaje específico), usa la pestaña de **clonación de voz**. 1. Abre la pestaña de clonación. 2. Pulsa el botón para **clonar una voz**. 3. En el formulario, completa: * **Nombre de la voz** (obligatorio) * **Descripción** (opcional) * **Idioma** (obligatorio) * **Género** (obligatorio) 4. Añade una **muestra de voz** (obligatorio) usando una de las opciones disponibles: * Subir audio * Grabar voz 5. Sigue los pasos en pantalla para enviar tu muestra. Cuando se cree tu voz clonada, aparecerá en tu lista de voces clonadas y podrás asignarla como cualquier otra voz. > **Error común:** Subir un clip demasiado corto o con ruido de fondo. Tu clon sonará notablemente peor si la muestra no es limpia. ## Recomendaciones y buenas prácticas para clonar voces Al grabar o subir tu muestra, sigue estas recomendaciones: * Graba en un **entorno silencioso** con el menor ruido de fondo posible * **Habla con claridad** a un ritmo natural * Para archivos subidos, aporta **al menos 30 segundos** de habla continua * El tamaño máximo de archivo es **4 MB** * Los idiomas compatibles incluyen: **inglés, italiano, francés, alemán, portugués, español, neerlandés, árabe e hindi** > **Importante:** Solo sube audio que tengas permiso para usar (por ejemplo, tu propia voz o una voz con licencia). # Voci Source: https://support.callin.io/Create-AI-Agent/Clone-Voice-copied-3 Sfoglia e ascolta tutte le voci IA disponibili, assegna una voce a un agente oppure clona una voce per ottenere un risultato personalizzato. ## Aprire la pagina Voci La sezione **Voci** è il punto in cui gestisci come “suonano” i tuoi agenti. Da qui puoi: * Sfogliare la **libreria di voci** (voci pronte all’uso) * **Ascoltare** un’anteprima prima di scegliere * **Assegnare** una voce a un agente specifico * **Clonare una voce** per creare una voce personalizzata Vai alla sezione **Voci** facendo clic qui: [Sezione Voci](https://app.callin.io/voices)Schermata: la pagina Voci dove puoi ascoltare le voci disponibili e accedere all’area di clonazione.
## Sfogliare e ascoltare le voci Quando apri questa pagina vedrai la **libreria di voci**. In genere, ogni riga include: * Un pulsante di **riproduzione** per ascoltare un’anteprima * Il **nome della voce** e una breve descrizione dello stile (ad esempio: calma, rassicurante, energica) * **Etichette informative** come genere, lingua e accento * Un’azione a destra per **assegnare** quella voce a un agente Per trovare più rapidamente una voce, puoi usare: * La **barra di ricerca** (ricerca per nome o per accento) * Filtri come il **genere** e altri menu a tendina disponibili (le opzioni possono variare in base all’account o al piano) > **Suggerimento:** per confrontare le voci in modo oggettivo, usa sempre lo stesso mini copione. > > Esempio: “Ciao! Sono Maya di NovaDent. Ti chiamo per confermare l’appuntamento di giovedì alle 15:00.” ## Assegnare una voce a un agente Per fare in modo che un agente parli con una voce specifica: 1. Nella libreria, trova la voce che vuoi usare. 2. Usa l’azione a destra per **assegnarla**. 3. Nella finestra di assegnazione, seleziona l’agente da aggiornare. 4. Conferma per salvare la modifica. Dopo l’assegnazione, l’agente userà la voce selezionata durante le chiamate. > **Importante:** puoi cambiare voce in qualsiasi momento assegnandone un’altra. Di norma, la voce si imposta per singolo agente. ## Clonare una voce Se desideri un risultato più personalizzato (ad esempio una voce di brand o un personaggio), puoi clonare una voce da questa sezione. 1. Apri l’area di clonazione della voce. 2. Fai clic sul pulsante per creare una nuova voce clonata. 3. Nel modulo, compila: * **Nome della voce** (obbligatorio) * **Descrizione** (facoltativa) * **Lingua** (obbligatoria) * **Genere** (obbligatorio) 4. Aggiungi un **campione vocale** (obbligatorio) scegliendo una delle opzioni disponibili: * Caricamento di un file audio * Registrazione della tua voce 5. Segui i passaggi a schermo per inviare il campione. Una volta creata, la voce clonata comparirà nell’elenco delle tue voci clonata e potrà essere assegnata come qualsiasi altra voce. > **Errore comune:** usare un campione troppo corto o con rumore di fondo. Una registrazione pulita migliora molto il risultato finale. ## Linee guida e buone pratiche per la clonazione Quando registri o carichi il campione, segui queste indicazioni: * Registra in un **ambiente silenzioso**, con il minimo rumore possibile * **Parla in modo chiaro** a un ritmo naturale * Se carichi un file, fornisci **almeno 30 secondi** di parlato continuo * La dimensione massima del file è **4 MB** * Le lingue supportate includono: **inglese, italiano, francese, tedesco, portoghese, spagnolo, olandese, arabo e hindi** > **Importante:** carica solo audio che hai il diritto di utilizzare (ad esempio la tua voce o una voce per cui possiedi una licenza). # Voix Source: https://support.callin.io/Create-AI-Agent/Clone-Voice-copied-4 Parcourez et écoutez toutes les voix IA disponibles, assignez une voix à un agent ou clonez une voix pour obtenir un rendu personnalisé. ## Ouvrir la page Voix La section **Voix** vous permet de gérer la façon dont vos agents sonnent. Depuis cette page, vous pouvez : * Parcourir la **bibliothèque de voix** (voix prêtes à l’emploi) * **Écouter** des extraits avant utilisation * **Assigner** une voix à un agent spécifique * **Cloner une voix** pour que votre agent parle avec un son personnalisé Accédez à la section **Voix** ici : [Voix](https://app.callin.io/voices)Capture : La page Voix où vous pouvez écouter des voix de la bibliothèque et accéder au clonage de voix.
## Parcourir et écouter les voix Lorsque vous ouvrez cette page, vous voyez la **bibliothèque de voix**. Chaque ligne de voix contient généralement : * Un bouton de **lecture** pour écouter un extrait * Le **nom de la voix** et une courte description du style (par exemple : calme, rassurante, énergique) * Des **étiquettes de détails** comme le genre, la langue et l’accent * Une action à droite pour **assigner** cette voix à un agent Vous pouvez aussi affiner la liste grâce à : * La **barre de recherche** (recherche par nom ou par accent) * Des filtres comme le **genre** et d’autres menus (les options peuvent varier selon votre compte ou votre offre) > **Astuce :** Pour comparer les voix, utilisez toujours le même petit script. > > Exemple : « Bonjour ! Ici Maya de NovaDent. Je vous appelle pour confirmer votre rendez-vous de jeudi à 15 h. » ## Assigner une voix à un agent Pour qu’un agent parle avec une voix spécifique : 1. Dans la bibliothèque de voix, trouvez la voix souhaitée. 2. Utilisez l’action à droite pour **l’assigner**. 3. Dans la fenêtre d’assignation, sélectionnez l’agent à mettre à jour. 4. Confirmez pour enregistrer le changement. Une fois assignée, l’agent utilisera cette voix pendant les appels. > **Important :** Vous pouvez changer la voix plus tard en en assignant une autre. En général, le choix de la voix se fait par agent. ## Cloner une voix Si vous souhaitez un rendu plus personnalisé (pour une voix de marque ou un personnage), vous pouvez cloner une voix depuis cette section. 1. Ouvrez la zone de clonage de voix. 2. Cliquez sur le bouton pour créer une nouvelle voix clonée. 3. Dans le formulaire, renseignez : * **Nom de la voix** (obligatoire) * **Description** (facultatif) * **Langue** (obligatoire) * **Genre** (obligatoire) 4. Ajoutez un **échantillon de voix** (obligatoire) en : * Téléversant un fichier audio * Enregistrant votre voix 5. Suivez les étapes à l’écran pour envoyer l’échantillon. Une fois créée, la voix clonée apparaîtra dans la liste des voix clonées et pourra être assignée comme n’importe quelle autre voix. > **Erreur fréquente :** Utiliser un échantillon trop court ou avec du bruit de fond. Un enregistrement propre change vraiment le résultat. ## Règles et bonnes pratiques pour le clonage de voix Pour enregistrer ou téléverser votre échantillon, respectez ces recommandations : * Enregistrez dans un **endroit calme**, avec un minimum de bruit de fond * **Parlez clairement** à un rythme naturel * Pour les fichiers téléversés, fournissez **au moins 30 secondes** de parole continue * La taille maximale du fichier est de **4 MB** * Les langues prises en charge incluent : **anglais, italien, français, allemand, portugais, espagnol, néerlandais, arabe et hindi** > **Important :** Ne téléversez que de l’audio que vous avez le droit d’utiliser (par exemple votre propre voix ou une voix sous licence). # Concurrent Calls Source: https://support.callin.io/Create-AI-Agent/ConcurrentCalls How simultaneous calls work and how they affect your plan. ## Before you begin In Callin, your voice agents may receive more than one call at the same time. To handle this, each plan includes a specific number of Concurrent Calls. This number determines how many conversations your agent can manage simultaneously without placing callers on hold. Understanding this concept is essential to choosing the right plan based on your call volume. ## Step 1: What a concurrent call actually is A concurrent call is a call that the system is actively handling at that exact moment. If your plan includes 3 concurrent calls, your agent can maintain up to 3 active conversations at the same time. A fourth incoming call will either wait or follow your flow logic (such as a busy message). Next, you’ll see how concurrent calls differ across Callin plans. ## Step 2: Concurrent Calls per plan Below is the number of simultaneous calls included in each Callin plan and what that means in practice. ### Basic Plan – 3 Concurrent Calls Includes: Up to 3 calls handled at the same time. Best for: Businesses getting started, with low call traffic or early testing of voice agents. ### Starter Plan (White Label) – 8 Concurrent Calls Includes: Up to 8 simultaneous calls. Best for: Managing multiple clients or operating a business with steady but not high call volume. ### Premium Plan (White Label) – 15 Concurrent Calls Includes: Up to 15 simultaneous calls. Best for: Agencies or teams serving several clients with consistent daily call traffic. ### Unlimited Plan (White Label) – 80 Concurrent Calls Includes: Up to 80 simultaneous calls. Additional concurrent calls available for \$7 each. Best for: High-volume operations, multi-client setups, or support centers that require strong capacity. ### Unlimited Plus – 80 Concurrent Calls (included) Includes: 80 built-in concurrent calls. Additional capacity available for \$7 per extra concurrent call. 15,000 minutes included. Best for: Teams that need maximum performance, stability, and scalable capacity for rapid growth. ## Step 3: How to determine how many concurrent calls you need Here are practical scenarios to help you decide the right capacity: If your company gets peaks of 5 to 7 calls at once: you’ll need at least 8 concurrent calls. If you work with multiple clients: make sure the total simultaneous calls across all accounts fit within your limit. If one client runs marketing campaigns or automated outreach: it's wise to have extra capacity for traffic spikes. If your concurrent calls run out: callers may hear a busy message or fail to connect. ## Advanced settings (optional) If your call volume varies, you can use: Usage monitoring inside the Callin dashboard to check if you frequently hit your limit. Purchase of additional concurrent calls (Unlimited and Unlimited Plus plans only) to expand your capacity as needed. ## Common mistakes and solutions Issue: Incoming calls fail to connect. Possible cause: The concurrent call limit has been reached. Solution: Review your usage and consider upgrading your plan or adding more capacity. Issue: Callers are placed on hold or hear waiting audio. Cause: The agent is handling the maximum number of simultaneous calls. Solution: Increase your concurrent call capacity to ensure continuous availability. Issue: Confusing minutes with concurrent calls. Solution: Remember that minutes refer to total monthly consumption, while concurrent calls refer to real-time capacity. ## Motivating close Understanding your concurrent call capacity helps you size your voice agents correctly and ensure every caller gets an immediate response. As your operation grows, you can always expand your capacity or switch plans without any disruption. # Gleichzeitige Anrufe Source: https://support.callin.io/Create-AI-Agent/ConcurrentCalls-copied-1 Wie gleichzeitige Anrufe funktionieren und wie sie deinen Plan beeinflussen. ## Bevor du beginnst In Callin können deine Sprachagenten mehr als einen Anruf zur gleichen Zeit erhalten. Um das zu bewältigen, enthält jeder Plan eine bestimmte Anzahl an gleichzeitigen Anrufen (Concurrent Calls). Diese Zahl bestimmt, wie viele Gespräche dein Agent parallel führen kann, ohne Anrufende in eine Warteschleife zu setzen. Dieses Konzept zu verstehen ist entscheidend, um den richtigen Plan basierend auf deinem Anrufvolumen zu wählen. ## Schritt 1: Was ein gleichzeitiger Anruf eigentlich ist Ein gleichzeitiger Anruf ist ein Anruf, den das System genau in diesem Moment aktiv bearbeitet. Wenn dein Plan 3 gleichzeitige Anrufe umfasst, kann dein Agent bis zu 3 aktive Gespräche parallel führen. Ein vierter eingehender Anruf wird entweder warten oder deiner Flow-Logik folgen (zum Beispiel mit einer Besetzt-Nachricht). Als Nächstes siehst du, wie sich gleichzeitige Anrufe je nach Callin-Plan unterscheiden. ## Schritt 2: Gleichzeitige Anrufe pro Plan Unten siehst du die Anzahl der in jedem Callin-Plan enthaltenen gleichzeitigen Anrufe und was das in der Praxis bedeutet. ### Basic Plan – 3 gleichzeitige Anrufe Enthält: Bis zu 3 Anrufe, die gleichzeitig bearbeitet werden. Am besten für: Unternehmen, die gerade starten, mit geringem Anrufaufkommen oder für erste Tests von Sprachagenten. ### Starter Plan (White Label) – 8 gleichzeitige Anrufe Enthält: Bis zu 8 gleichzeitige Anrufe. Am besten für: Die Verwaltung mehrerer Kunden oder den Betrieb eines Unternehmens mit stabilem, aber nicht hohem Anrufvolumen. ### Premium Plan (White Label) – 15 gleichzeitige Anrufe Enthält: Bis zu 15 gleichzeitige Anrufe. Am besten für: Agenturen oder Teams, die mehrere Kunden mit konstantem täglichem Anrufaufkommen betreuen. ### Unlimited Plan (White Label) – 80 gleichzeitige Anrufe Enthält: Bis zu 80 gleichzeitige Anrufe. Zusätzliche gleichzeitige Anrufe sind für jeweils \$7 verfügbar. Am besten für: High-Volume-Operationen, Multi-Client-Setups oder Support-Center, die eine hohe Kapazität benötigen. ### Unlimited Plus – 80 gleichzeitige Anrufe (inklusive) Enthält: 80 integrierte gleichzeitige Anrufe. Zusätzliche Kapazität ist für \$7 pro zusätzlichem gleichzeitigem Anruf verfügbar. 15.000 Minuten inklusive. Am besten für: Teams, die maximale Performance, Stabilität und skalierbare Kapazität für schnelles Wachstum benötigen. ## Schritt 3: So bestimmst du, wie viele gleichzeitige Anrufe du brauchst Hier sind praktische Szenarien, die dir helfen, die richtige Kapazität zu wählen: Wenn dein Unternehmen Spitzen von 5 bis 7 gleichzeitigen Anrufen hat: Du brauchst mindestens 8 gleichzeitige Anrufe. Wenn du mit mehreren Kunden arbeitest: Stelle sicher, dass die Gesamtzahl gleichzeitiger Anrufe über alle Accounts hinweg innerhalb deines Limits liegt. Wenn ein Kunde Marketingkampagnen oder automatisierten Outreach betreibt: Es ist sinnvoll, zusätzliche Kapazität für Traffic-Spitzen einzuplanen. Wenn deine gleichzeitigen Anrufe ausgeschöpft sind: Anrufende hören möglicherweise eine Besetzt-Nachricht oder können sich nicht verbinden. ## Erweiterte Einstellungen (optional) Wenn dein Anrufvolumen schwankt, kannst du Folgendes nutzen: Nutzungsmonitoring im Callin-Dashboard, um zu prüfen, ob du dein Limit häufig erreichst. Zukauf zusätzlicher gleichzeitiger Anrufe (nur in den Plänen Unlimited und Unlimited Plus), um deine Kapazität bei Bedarf zu erweitern. ## Häufige Fehler und Lösungen Problem: Eingehende Anrufe lassen sich nicht verbinden. Mögliche Ursache: Das Limit für gleichzeitige Anrufe wurde erreicht. Lösung: Prüfe deine Nutzung und erwäge ein Upgrade deines Plans oder das Hinzufügen weiterer Kapazität. Problem: Anrufende werden in eine Warteschleife gelegt oder hören Warteton. Ursache: Der Agent bearbeitet bereits die maximale Anzahl gleichzeitiger Anrufe. Lösung: Erhöhe deine Kapazität für gleichzeitige Anrufe, um durchgehende Erreichbarkeit sicherzustellen. Problem: Verwechslung von Minuten mit gleichzeitigen Anrufen. Lösung: Minuten beziehen sich auf den monatlichen Gesamtverbrauch, während gleichzeitige Anrufe die Kapazität in Echtzeit beschreiben. ## Abschließender Hinweis Wenn du deine Kapazität für gleichzeitige Anrufe verstehst, kannst du deine Sprachagenten korrekt dimensionieren und sicherstellen, dass jede anrufende Person sofort eine Antwort erhält. Wenn dein Betrieb wächst, kannst du deine Kapazität jederzeit erweitern oder den Plan wechseln — ohne Unterbrechung. # Llamadas concurrentes Source: https://support.callin.io/Create-AI-Agent/ConcurrentCalls-copied-2 Cómo funcionan las llamadas simultáneas y cómo afectan a tu plan. ## Antes de empezar En Callin, tus agentes de voz pueden recibir más de una llamada al mismo tiempo. Para gestionarlo, cada plan incluye un número específico de Llamadas concurrentes. Este número determina cuántas conversaciones puede manejar tu agente simultáneamente sin poner a los llamantes en espera. Entender este concepto es esencial para elegir el plan correcto según tu volumen de llamadas. ## Paso 1: Qué es realmente una llamada concurrente Una llamada concurrente es una llamada que el sistema está gestionando activamente en ese mismo momento. Si tu plan incluye 3 llamadas concurrentes, tu agente puede mantener hasta 3 conversaciones activas a la vez. Una cuarta llamada entrante tendrá que esperar o seguirá tu lógica de flujo (por ejemplo, un mensaje de ocupado). A continuación, verás cómo varían las llamadas concurrentes entre los planes de Callin. ## Paso 2: Llamadas concurrentes por plan A continuación se indica el número de llamadas simultáneas incluidas en cada plan de Callin y lo que significa en la práctica. ### Plan Basic – 3 llamadas concurrentes Incluye: Hasta 3 llamadas gestionadas al mismo tiempo. Ideal para: Empresas que están empezando, con poco tráfico de llamadas o en fase inicial de pruebas de agentes de voz. ### Plan Starter (White Label) – 8 llamadas concurrentes Incluye: Hasta 8 llamadas simultáneas. Ideal para: Gestionar varios clientes u operar un negocio con un volumen de llamadas estable pero no alto. ### Plan Premium (White Label) – 15 llamadas concurrentes Incluye: Hasta 15 llamadas simultáneas. Ideal para: Agencias o equipos que atienden a varios clientes con tráfico de llamadas diario constante. ### Plan Unlimited (White Label) – 80 llamadas concurrentes Incluye: Hasta 80 llamadas simultáneas. Llamadas concurrentes adicionales disponibles por \$7 cada una. Ideal para: Operaciones de alto volumen, configuraciones multi-cliente o centros de soporte que requieren gran capacidad. ### Unlimited Plus – 80 llamadas concurrentes (incluidas) Incluye: 80 llamadas concurrentes incluidas. Capacidad adicional disponible por \$7 por cada llamada concurrente extra. 15.000 minutos incluidos. Ideal para: Equipos que necesitan el máximo rendimiento, estabilidad y capacidad escalable para crecer rápidamente. ## Paso 3: Cómo determinar cuántas llamadas concurrentes necesitas Aquí tienes escenarios prácticos para ayudarte a decidir la capacidad adecuada: Si tu empresa tiene picos de 5 a 7 llamadas a la vez: necesitarás al menos 8 llamadas concurrentes. Si trabajas con múltiples clientes: asegúrate de que el total de llamadas simultáneas entre todas las cuentas encaje dentro de tu límite. Si un cliente ejecuta campañas de marketing o outreach automatizado: es recomendable tener capacidad extra para picos de tráfico. Si te quedas sin llamadas concurrentes: los llamantes pueden escuchar un mensaje de ocupado o no conseguir conectarse. ## Ajustes avanzados (opcional) Si tu volumen de llamadas varía, puedes usar: Monitoreo de uso dentro del panel de Callin para comprobar si alcanzas tu límite con frecuencia. Compra de llamadas concurrentes adicionales (solo en los planes Unlimited y Unlimited Plus) para ampliar tu capacidad cuando lo necesites. ## Errores comunes y soluciones Problema: Las llamadas entrantes no conectan. Posible causa: Se alcanzó el límite de llamadas concurrentes. Solución: Revisa tu uso y considera actualizar tu plan o añadir más capacidad. Problema: Los llamantes quedan en espera o escuchan audio de espera. Causa: El agente está gestionando el número máximo de llamadas simultáneas. Solución: Aumenta tu capacidad de llamadas concurrentes para garantizar disponibilidad continua. Problema: Confundir minutos con llamadas concurrentes. Solución: Recuerda que los minutos se refieren al consumo mensual total, mientras que las llamadas concurrentes se refieren a la capacidad en tiempo real. ## Cierre motivador Entender tu capacidad de llamadas concurrentes te ayuda a dimensionar correctamente tus agentes de voz y a asegurar que cada llamante reciba una respuesta inmediata. A medida que tu operación crece, siempre puedes ampliar tu capacidad o cambiar de plan sin ninguna interrupción. # Chiamate simultanee Source: https://support.callin.io/Create-AI-Agent/ConcurrentCalls-copied-3 Come funzionano le chiamate simultanee e come influiscono sul tuo piano. ## Prima di iniziare In Callin, i tuoi agenti vocali possono ricevere più di una chiamata nello stesso momento. Per gestire questa situazione, ogni piano include un numero specifico di **chiamate simultanee**. Questo numero determina quante conversazioni il tuo agente può gestire contemporaneamente senza mettere i chiamanti in attesa. Capire questo concetto è essenziale per scegliere il piano giusto in base al volume di chiamate. ## Passaggio 1: Che cos’è davvero una chiamata simultanea Una chiamata simultanea è una chiamata che il sistema sta gestendo attivamente in quell’esatto momento. Se il tuo piano include 3 chiamate simultanee, il tuo agente può mantenere fino a 3 conversazioni attive nello stesso momento. Una quarta chiamata in arrivo dovrà aspettare oppure seguirà la logica del tuo flusso (ad esempio un messaggio di occupato). Qui sotto vedrai come le chiamate simultanee cambiano tra i piani Callin. ## Passaggio 2: Chiamate simultanee per piano Di seguito trovi il numero di chiamate simultanee incluse in ciascun piano Callin e cosa significa in pratica. ### Piano Basic – 3 chiamate simultanee Include: Fino a 3 chiamate gestite nello stesso momento. Ideale per: aziende che stanno iniziando, con poco traffico o nelle prime fasi di test degli agenti vocali. ### Piano Starter (White Label) – 8 chiamate simultanee Include: Fino a 8 chiamate simultanee. Ideale per: gestire più clienti o un’attività con un traffico costante ma non elevato. ### Piano Premium (White Label) – 15 chiamate simultanee Include: Fino a 15 chiamate simultanee. Ideale per: agenzie o team che servono diversi clienti con traffico quotidiano costante. ### Piano Unlimited (White Label) – 80 chiamate simultanee Include: Fino a 80 chiamate simultanee. Chiamate simultanee aggiuntive disponibili a \$7 ciascuna. Ideale per: operazioni ad alto volume, setup multi-cliente o centri di supporto che richiedono grande capacità. ### Unlimited Plus – 80 chiamate simultanee (incluse) Include: 80 chiamate simultanee incluse. Capacità aggiuntiva disponibile a \$7 per ogni chiamata simultanea extra. 15.000 minuti inclusi. Ideale per: team che necessitano massime prestazioni, stabilità e capacità scalabile per una crescita rapida. ## Passaggio 3: Come capire quante chiamate simultanee ti servono Ecco alcuni scenari pratici per aiutarti a scegliere la capacità corretta: Se la tua azienda ha picchi di 5–7 chiamate contemporanee: ti servono almeno 8 chiamate simultanee. Se lavori con più clienti: assicurati che il totale delle chiamate contemporanee su tutti gli account rientri nel limite. Se un cliente esegue campagne marketing o outreach automatizzato: è consigliabile avere capacità extra per gestire i picchi di traffico. Se esaurisci le chiamate simultanee: i chiamanti potrebbero sentire un messaggio di occupato o non riuscire a connettersi. ## Impostazioni avanzate (facoltative) Se il volume di chiamate varia, puoi usare: Monitoraggio dell’utilizzo nella dashboard Callin per verificare se raggiungi spesso il limite. Acquisto di chiamate simultanee aggiuntive (solo piani Unlimited e Unlimited Plus) per aumentare la capacità quando necessario. ## Errori comuni e soluzioni Problema: le chiamate in arrivo non si connettono. Possibile causa: è stato raggiunto il limite di chiamate simultanee. Soluzione: controlla l’utilizzo e valuta l’upgrade del piano o l’aggiunta di capacità. Problema: i chiamanti vengono messi in attesa o sentono audio di attesa. Causa: l’agente sta gestendo il numero massimo di chiamate contemporanee. Soluzione: aumenta la capacità di chiamate simultanee per garantire disponibilità continua. Problema: confondere minuti e chiamate simultanee. Soluzione: ricorda che i minuti si riferiscono al consumo mensile totale, mentre le chiamate simultanee indicano la capacità in tempo reale. ## Chiusura motivazionale Capire la tua capacità di chiamate simultanee ti aiuta a dimensionare correttamente i tuoi agenti vocali e a garantire che ogni chiamante riceva una risposta immediata. Man mano che la tua attività cresce, puoi sempre espandere la capacità o cambiare piano senza alcuna interruzione. # Appels simultanés Source: https://support.callin.io/Create-AI-Agent/ConcurrentCalls-copied-4 Comment fonctionnent les appels simultanés et comment ils affectent votre forfait. ## Avant de commencer Dans Callin, vos agents vocaux peuvent recevoir plus d’un appel en même temps. Pour gérer cela, chaque forfait inclut un nombre spécifique d’**appels simultanés** (Concurrent Calls). Ce nombre détermine combien de conversations votre agent peut gérer en parallèle **sans mettre les appelants en attente**. Comprendre ce concept est essentiel pour choisir le bon forfait en fonction de votre volume d’appels. ## Étape 1 : Ce qu’est réellement un appel simultané Un appel simultané est un appel que le système gère **activement** à un instant donné. Si votre forfait inclut **3 appels simultanés**, votre agent peut maintenir **jusqu’à 3 conversations actives** en même temps. Un **quatrième** appel entrant devra soit attendre, soit suivre votre logique de flux (par exemple, un message d’occupation). Ensuite, vous verrez comment les appels simultanés varient selon les forfaits Callin. ## Étape 2 : Appels simultanés par forfait Vous trouverez ci-dessous le nombre d’appels simultanés inclus dans chaque forfait Callin et ce que cela signifie en pratique. ### Forfait Basic – 3 appels simultanés Inclut : * Jusqu’à **3 appels** gérés en même temps. Idéal pour : les entreprises qui démarrent, avec un faible trafic d’appels ou des tests initiaux d’agents vocaux. ### Forfait Starter (marque blanche) – 8 appels simultanés Inclut : * Jusqu’à **8 appels** simultanés. Idéal pour : gérer plusieurs clients ou exploiter une activité avec un volume d’appels stable mais pas élevé. ### Forfait Premium (marque blanche) – 15 appels simultanés Inclut : * Jusqu’à **15 appels** simultanés. Idéal pour : les agences ou équipes au service de plusieurs clients avec un trafic d’appels quotidien constant. ### Forfait Unlimited (marque blanche) – 80 appels simultanés Inclut : * Jusqu’à **80 appels** simultanés. * Des appels simultanés supplémentaires disponibles pour **7 \$** chacun. Idéal pour : les opérations à fort volume, les configurations multi-clients, ou les centres de support nécessitant une forte capacité. ### Forfait Unlimited Plus – 80 appels simultanés (inclus) Inclut : * **80** appels simultanés inclus. * Capacité supplémentaire disponible pour **7 \$** par appel simultané additionnel. * **15 000 minutes** incluses. Idéal pour : les équipes qui ont besoin de performances maximales, de stabilité et d’une capacité évolutive pour une croissance rapide. ## Étape 3 : Comment déterminer combien d’appels simultanés vous avez besoin Voici des scénarios pratiques pour vous aider à choisir la bonne capacité : * Si votre entreprise connaît des pics de **5 à 7 appels** en même temps : vous aurez besoin d’au moins **8 appels simultanés**. * Si vous travaillez avec plusieurs clients : assurez-vous que le total d’appels simultanés **sur l’ensemble des comptes** reste dans votre limite. * Si un client lance des campagnes marketing ou de l’outreach automatisé : il est conseillé d’avoir une capacité supplémentaire pour absorber les pics de trafic. * Si vous atteignez votre limite d’appels simultanés : les appelants peuvent entendre un message d’occupation ou ne pas réussir à se connecter. ## Paramètres avancés (optionnels) Si votre volume d’appels varie, vous pouvez utiliser : * Le suivi d’utilisation dans le tableau de bord Callin pour vérifier si vous atteignez fréquemment votre limite. * L’achat d’appels simultanés supplémentaires (uniquement pour les forfaits **Unlimited** et **Unlimited Plus**) afin d’augmenter la capacité selon vos besoins. ## Erreurs courantes et solutions **Problème : Les appels entrants ne se connectent pas.**\ Cause possible : la limite d’appels simultanés a été atteinte.\ Solution : vérifiez votre utilisation et envisagez de passer à un forfait supérieur ou d’ajouter de la capacité. **Problème : Les appelants sont mis en attente ou entendent un son d’attente.**\ Cause : l’agent gère déjà le nombre maximal d’appels en parallèle.\ Solution : augmentez votre capacité d’appels simultanés pour garantir une disponibilité continue. **Problème : Confondre minutes et appels simultanés.**\ Solution : retenez que les **minutes** correspondent à la consommation totale mensuelle, tandis que les **appels simultanés** correspondent à la capacité en temps réel. ## Conclusion motivante Comprendre votre capacité d’appels simultanés vous aide à dimensionner correctement vos agents vocaux et à garantir que chaque appelant obtienne une réponse immédiate. À mesure que votre activité grandit, vous pouvez toujours augmenter votre capacité ou changer de forfait, sans aucune interruption. # Numbers And BYOC Source: https://support.callin.io/Create-AI-Agent/Configure-Numbers Learn how to buy, import, or verify phone numbers—and how to connect BYOC (SIP Trunk)—so your AI agents can make and receive calls. ## Overview Phone numbers are the bridge between your AI agents and real phone calls. In Callin.io, you’ll manage this in two places: * **Numbers**: Buy numbers through Callin.io, import from providers, or verify a personal number. * **BYOC (SIP Trunk)**: Bring your own carrier by connecting Telnyx or any SIP provider. Use these shortcuts to jump straight into the app: * Go to **Numbers**: [Open Numbers](https://app.callin.io/numbers) * Go to **BYOC (SIP Trunk)**: [Open BYOC](https://app.callin.io/byoc) > **Tip:** If you’re getting started quickly, buy a **US/Canada** number (instant). If you need an international number, be ready to submit documents (country rules vary). *** ## Numbers The **Numbers** page shows every number connected to your workspace (purchased, imported, personal, Telnyx, or BYOC). From here, you can add new numbers and confirm each number’s status.Screenshot: The Numbers page where you can filter by provider and click + Add Number to purchase or import numbers.
### What you can do in Numbers When you click **+ Add Number**, you’ll typically see these options (wording may vary slightly by account/plan): * **Purchase Number** (buy through Callin.io) * **Import from Twilio** * **Add Personal Number** * **Add Telnyx Number** (after Telnyx is connected) You’ll also usually see filters like **Purchased**, **Twilio**, **Personal**, **Telnyx**, and **BYOC (SIP Trunk)** to quickly find what you’re looking for. *** ### Option A: Purchase a number through Callin.io Buying numbers through Callin.io is the simplest way to get started. #### US & Canada: instant purchase For **United States** and **Canada**, the purchase flow is typically instant: 1. Go to [Open Numbers](https://app.callin.io/numbers). 2. Click **+ Add Number** → **Purchase Number**. 3. Choose the **Country**. 4. Choose a type: * **Local** * **Toll-Free** (if available) 5. (Optional) Use **Search by Area Code** (example: `415`). 6. Click **Search Numbers**. 7. Select a number from the list. 8. Click **Purchase Selected Number**. > **Important:** After purchase, the number should appear in your list. If you see a warning like “this number is not assigned to any agent,” you still need to assign it to an agent before using it. #### Other countries: request + documentationCaptura: after you start the request, the platform loads the country-specific fields and documents you must complete before payment and review.
For many **non-US/Canada** countries, purchasing is a **request-based** flow rather than an instant checkout. * You select the country and number type (for example **Local** or **Mobile**). * You may see **Request Type** options such as **New number** and **Porting**. * You choose one of the available numbers and click **Start request**. * The platform then loads the **country-specific** information and documentation requirements. * You must complete the required fields, upload documents, and save each item. * You submit the request, pay any required fees, and then the request is reviewed by an operator. You can typically track these under a tab like **Number Requests**. This part of the process is important because the requirements are not always the same. They can change depending on the **country**, the **number type**, and whether the request is being made by an **individual**, a **sole proprietorship**, or a **company**. ##### How the documentation step works After you click **Start request**, the form may show a combination of: * Text fields you must complete manually * Upload fields for supporting documents * A **Save** button for each individual requirement * A **Pending** status until that specific item is correctly saved or uploaded This means the request is usually completed **piece by piece**, not all at once. If a field or upload still shows **Pending**, that requirement is normally not complete yet. In many request-based countries, the form can ask for details such as: * **Identity document type** * **Identity document number** * **Date of birth** * **Place of birth** * **Identity document issuer** * **Identity document expiration date** * **Local address in the same country** * **Personal Tax Code** * **VAT number** * **Company Tax Code** * **IT Customer Type** * **Proof of Address** * **Passport/ID copy** * **Company Registration certificate** Some labels may also clarify who must provide each item, for example: * **For legal entities only** * **For legal entities and sole proprietorships only** * **For natural persons and sole proprietorships only** So, even if two customers request numbers in the same country, the required documentation may differ depending on the business type and the exact number category. > **Tip:** In the request form, some fields have their own **Save** button. Entering a value is not always enough by itself. The item may continue to show **Pending** until you click **Save** successfully. ##### Common document requirements (examples) Exact requirements depend on the country and number type, but you may be asked for items like: | Requirement | What it means | Example | | -------------------------------------------- | --------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------- | | Address matching the DID area code | You may need an address in the same city, region, or coverage area as the number you are requesting | “Via Roma 22, Milan” for a Milan local number | | National ID / Tax ID | Personal or business identification used to validate the requester | Passport number, national ID, tax code, VAT number | | Contact info | A reachable person or company contact for the request | “Luca Bianchi, +39 345 000 1111” | | Proof of address (upload) | A document showing the address you entered in the request | Utility bill, bank statement, rental contract, or official government letter | | Passport/ID copy (upload) | Identity verification for an individual or company representative | Passport scan or front/back ID copy | | Business certificate (upload) | Proof that the company is legally registered | Certificate of incorporation, business registration extract | | Company Tax Code / VAT number | Business tax information for company-based requests | VAT registration number or company tax number | | Date and place of birth | Personal identification details required in some countries | “14 March 1988, Naples” | | Identity document issuer and expiration date | Information about the issuing authority and validity of the ID document | “Issued by Comune di Torino, expires 08/2028” | ##### Proof of address: what usually causes problems The **proof of address** document is one of the most common reasons a request is delayed. In many countries, the uploaded proof of address must meet all of these conditions: * It must clearly show the **same name** used in the request, or the company name if the request is for a business * It must clearly show the **same address** entered in the form * It must be **recent** * It must be complete and readable * It must not be cropped in a way that hides important details A very important rule is that the bill or address document often must be **no more than 3 months old** at the time of submission. That usually means you should upload a recent document such as: * A utility bill dated within the last 3 months * A bank statement dated within the last 3 months * An official government or tax letter dated within the last 3 months Older documents may be rejected even if the address itself is correct. > **Important:** When you upload a bill or bank statement as proof of address, make sure it is **less than 3 months old**. If the document is older, the request may remain pending or be rejected during review. ##### How to prepare documents before uploading To avoid delays, check each document before you upload it. A good document should be: * **Clear and readable** * **Complete**, not cut off at the edges * **Consistent** with the data entered in the form * **Current**, especially for address documents * **Relevant** to the requester type, whether individual or company For example, if the request is for a company, the reviewer may expect the company name, company number, tax details, and registration documents to match each other. If the request is for an individual, the reviewer may check that the personal name, ID document, and proof of address all match. Common issues that can slow approval include: * The address in the form does not match the uploaded document * The uploaded bill is older than 3 months * The passport or ID copy is blurry * A company request is submitted with personal documents only * A field is filled in, but the user did not click **Save** * A document was uploaded, but its status still shows **Pending** > **Common mistake:** Uploading the correct file is not always enough. After each upload or text entry, check that the requirement no longer shows **Pending**. ##### Fees + review Some countries show a **fee payment** step after the documentation is completed. This may include: * A **one-time activation fee** * The **monthly recurring cost** for the number The request generally moves forward only after the required documents are uploaded and the payment step is completed. After you submit and pay: * You’ll receive a **Request ID** * The request is reviewed by an operator * Once approved, the number appears in your Numbers list The review is manual in many cases, which is why approval is not always immediate. > **Important:** Approval timing can vary by country, provider rules, and document quality. If you need the number for an upcoming launch or campaign, submit the request as early as possible and use recent, clearly readable documents. *** ### Option B: Import numbers from Twilio If you already own numbers in Twilio, you can import them into Callin.io: 1. Go to [Open Numbers](https://app.callin.io/numbers). 2. Click **+ Add Number** → **Import from Twilio**. 3. Enter your **Twilio Account SID** and **Twilio Auth Token**. 4. Click **Search Twilio Numbers** and select the numbers to import. 5. Assign imported numbers to an AI agent when you’re ready to use them. > **Common mistake:** Copying the wrong Twilio credentials (for example, using a test credential instead of live). If no numbers appear, re-check your Twilio project and permissions. *** ### Option C: Add a Personal Number (outbound-only) A **Personal Number** is useful when you want to place outbound calls from your own phone number—but it cannot receive inbound calls inside Callin.io.Screenshot: The Add Personal Number modal with phone input and the verification process (you receive a verification call and enter the code).
#### Verify your personal number 1. Go to [Open Numbers](https://app.callin.io/numbers). 2. Click **+ Add Number** → **Add Personal Number**. 3. Select your country code and enter your phone number. 4. Click **Verify Number**. 5. You’ll receive a **verification call**. 6. Enter the verification code when prompted. 7. After verification, the number is added to your account. > **Important:** Personal numbers are **outbound-only**. If you need inbound calls, use a purchased/imported number or BYOC. *** ### Option D: Add/Import Telnyx numbers If your Telnyx account is connected (via BYOC), you can import active Telnyx numbers into Callin.io: 1. Go to [Open Numbers](https://app.callin.io/numbers). 2. Click **+ Add Number** → **Add Telnyx Number**. 3. Select the Telnyx numbers you want to add/import. 4. Confirm, then assign them to agents as needed. *** ### Assign numbers to agents (so they can be used) Buying or importing a number is only step one—your agent still needs to use it. On the Numbers list, if you see a warning like “not assigned to any agent,” assign the number to the right AI agent before going live. > **Tip:** Keep one “test” number separate from production while you’re iterating on prompts and call flows. *** ## BYOC (SIP Trunk) **BYOC** means **Bring Your Own Carrier**. Instead of buying numbers through Callin.io, you connect your own telephony provider using a SIP trunk. Typical reasons to use BYOC: * You already have a carrier contract (enterprise telephony) * You need custom routing, SBC control, or compliance constraints * You want to avoid Callin-managed telephony rules by using your own provider Go here to set it up: [Open BYOC](https://app.callin.io/byoc)Screenshot: BYOC setup where you can connect Telnyx and synchronize numbers into Callin.io.
### What is a SIP Trunk (simple explanation) A **SIP trunk** is a connection between a phone carrier and your calling system. Think of it like a “phone line over the internet” that can handle inbound/outbound calls—often used by businesses. *** ### Option 1: Connect Telnyx If you use **Telnyx**, Callin.io can guide the setup with an API key: 1. Go to [Open BYOC](https://app.callin.io/byoc). 2. Select the **Telnyx** tab. 3. Paste your **Telnyx API Key**. 4. Click **Start**. During setup, you’ll typically see steps like: * Saving the Telnyx API key * Fetching active Telnyx numbers (DIDs) * Storing numbers in your Callin.io account * Provisioning the SIP trunk (inbound + outbound) * Creating provider phone numbers Once it completes, your Telnyx numbers should appear under **Numbers**. > **Important:** If your Telnyx key doesn’t have permission to read numbers/DIDs, Callin.io won’t be able to fetch them. *** ### Option 2: Connect another SIP provider (Generic SIP Trunk) If your provider is not Telnyx, use the **Other SIP Provider** tab. You’ll typically configure three areas: **Basic**, **Inbound**, and **Outbound**. #### Basic * **Label**: A friendly name (example: “HQ SIP Trunk”) * **Phone Number (E.164)**: Full international format (example: `+15551234567`) * You may also see toggles like **Supports inbound** and **Supports outbound** #### Inbound Inbound calls go from the carrier to your system. * **Inbound SBC / FQDN**: Your SIP address (example: `sip.example.com:5061`) * **Transport**: Often **TLS** or **UDP** * **Media encryption**: Enable if your provider supports it > **Tip:** Inbound often does **not** require credentials. Many carriers authenticate inbound calls by IP allowlists or trunk configuration. #### Outbound Outbound calls go from Callin.io to your carrier. * **Outbound SBC / FQDN**: Your provider’s SIP server * **Transport** and **Media encryption** * **Username** and **Password**: Your SIP credentials * **Allowed countries (outbound)**: Often **Worldwide** or a **Custom list** When finished, click **Save & Import**. > **Common mistake:** Using the wrong SBC/FQDN or credentials. If outbound calls fail, re-check your SIP username/password and whether your provider requires a specific port or transport. *** ## Minutes and billing (what to expect) Billing can have two parts: **Callin usage** and **telephony carrier charges**. What you see depends on how you connect numbers. ### Callin compute minutes **Compute minutes** represent the time your AI agent is active (listening, processing, responding). This is the core usage metric for AI calling. ### Callin-managed telephony: important billing notice (first-minute billing) When you place calls using **Callin-managed telephony** (for example, numbers purchased through Callin.io and routed through Callin’s carrier), you may see a **first-minute billing** rule: * Minimum charge is **1 minute** * After the first minute, billing typically follows the actual call duration * This rule typically **does not apply** to: * **Browser test calls** * **Imported own numbering** (Telnyx or Twilio imports) * **External SIP trunk (BYOC)** > **Important:** The exact billing behavior can vary based on your setup and provider routing. If you want to avoid Callin-managed telephony rules, import your own numbers or use BYOC. ### Personal number billing reminder Personal numbers are **outbound-only**, and calls made using a personal number can still fall under Callin-managed telephony rules depending on how your account routes calls. *** ## Troubleshooting ### “I can’t make calls” * Check that you have at least **one active number** * Make sure the number is **assigned to an agent** * If using BYOC, confirm your SIP trunk settings are correct (SBC/FQDN, transport, credentials) ### “My personal number isn’t receiving inbound calls” * That’s expected: **Personal Numbers are outbound-only** * Use a purchased/imported number or BYOC for inbound calling ### “My imported numbers don’t show up” * Re-check credentials (Twilio SID/Auth Token, Telnyx API Key) * Confirm the numbers are active in the provider account * Try again and verify you’re using the correct project/sub-account in the provider *** ## Final note If you want the fastest setup, start with **a US/Canada number purchased in Callin.io**. If you need advanced routing or already have a carrier, connect **BYOC**. Once your number is added and assigned, your AI agents can place and receive real phone calls at scale. # Nummern und BYOC Source: https://support.callin.io/Create-AI-Agent/Configure-Numbers-copied-1 Erfahren Sie, wie Sie Telefonnummern kaufen, importieren oder verifizieren und BYOC (SIP Trunk) verbinden, damit Ihre KI-Agenten Anrufe tätigen und entgegennehmen können. ## Überblick Telefonnummern sind die Verbindung zwischen Ihren KI-Agenten und echten Telefonanrufen. In Callin.io verwalten Sie das an zwei Stellen: * **Nummern**: Kaufen Sie Nummern über Callin.io, importieren Sie sie von Anbietern oder verifizieren Sie eine persönliche Nummer. * **BYOC (SIP Trunk)**: Bringen Sie Ihren eigenen Carrier mit, indem Sie Telnyx oder einen beliebigen SIP-Anbieter verbinden. Nutzen Sie diese Schnellzugriffe, um jede Sektion in der App zu öffnen: * Zu **Nummern**: [Nummern öffnen](https://app.callin.io/numbers) * Zu **BYOC (SIP Trunk)**: [BYOC öffnen](https://app.callin.io/byoc) > **Tipp:** Wenn Sie schnell starten möchten, kaufen Sie eine Nummer für **USA oder Kanada** (meist sofort). Für internationale Nummern müssen Sie in der Regel Angaben machen und Dokumente hochladen (die Anforderungen unterscheiden sich je nach Land). *** ## Nummern Die Seite **Nummern** zeigt alle Nummern, die mit Ihrem Workspace verbunden sind (gekauft, importiert, persönlich, Telnyx oder BYOC). Hier können Sie neue Nummern hinzufügen, den Status prüfen und wichtige Hinweise sehen (zum Beispiel, wenn eine Nummer noch keinem Agenten zugewiesen ist).Screenshot: Die Nummern-Seite mit Anbieterfiltern und dem Menü zum Kaufen oder Importieren von Nummern.
### Was Sie in Nummern erledigen können Wenn Sie auf die Hinzufügen-Aktion klicken (zum Beispiel **+ Nummer hinzufügen**), sehen Sie üblicherweise Optionen wie (Bezeichnungen können je nach Konto, Plan oder Interface-Sprache variieren): * Nummer über Callin.io kaufen * Von Twilio importieren * Persönliche Nummer hinzufügen * Telnyx-Nummer hinzufügen (nachdem Telnyx verbunden wurde) Oft gibt es außerdem Filter nach Typ/Herkunft (gekauft, Twilio, persönlich, Telnyx, BYOC). *** ### Option A: Eine Nummer über Callin.io kaufen Nummern über Callin.io zu kaufen ist der direkteste Weg zum Start. #### USA und Kanada: Sofortkauf Für die **USA** und **Kanada** ist der Kaufablauf häufig schnell und sofort: 1. Gehen Sie zu [Nummern öffnen](https://app.callin.io/numbers). 2. Klicken Sie auf die Hinzufügen-Aktion und wählen Sie die Kaufoption. 3. Wählen Sie das **Land**. 4. Wählen Sie den Typ: * **Lokal** * **Gebührenfrei** (falls verfügbar) 5. (Optional) Suchen Sie nach **Vorwahl/Area Code** (Beispiel: `415`). 6. Starten Sie die Suche. 7. Wählen Sie eine Nummer aus der Liste. 8. Bestätigen Sie den Kauf der ausgewählten Nummer. > **Wichtig:** Wenn ein Hinweis erscheint, dass die Nummer keinem Agenten zugewiesen ist, ist sie noch nicht einsatzbereit: Weisen Sie sie zuerst einem Agenten zu. #### Andere Länder: Anfrage + DokumentationScreenshot: Nachdem Sie die Anfrage gestartet haben, lädt die Plattform die länderspezifischen Felder und Dokumente, die Sie vor Zahlung und Prüfung ausfüllen müssen.
Für viele Länder **außerhalb der USA/Kanadas** erfolgt der Kauf über einen **anfragebasierten** Ablauf statt über einen sofortigen Kauf. * Sie wählen das Land und den Nummerntyp aus, zum Beispiel **Lokal** oder **Mobil**. * Möglicherweise sehen Sie **Anfragetyp**-Optionen wie **Neue Nummer** und **Portierung**. * Sie wählen eine der verfügbaren Nummern aus und klicken auf **Anfrage starten**. * Die Plattform lädt dann die **länderspezifischen** Informations- und Dokumentationsanforderungen. * Sie müssen die erforderlichen Felder ausfüllen, Dokumente hochladen und jedes Element speichern. * Sie senden die Anfrage ab, bezahlen eventuell erforderliche Gebühren, und anschließend wird die Anfrage von einem Betreiber geprüft. Sie können diese Anfragen normalerweise unter einer Registerkarte wie **Nummernanfragen** verfolgen. Dieser Teil des Prozesses ist wichtig, weil die Anforderungen nicht immer gleich sind. Sie können sich je nach **Land**, **Nummerntyp** und danach unterscheiden, ob die Anfrage von einer **Privatperson**, einem **Einzelunternehmen** oder einem **Unternehmen** gestellt wird. ##### So funktioniert der Dokumentationsschritt Nachdem Sie auf **Anfrage starten** geklickt haben, kann das Formular Folgendes anzeigen: * Textfelder, die Sie manuell ausfüllen müssen * Upload-Felder für unterstützende Dokumente * Eine **Speichern**-Schaltfläche für jede einzelne Anforderung * Einen Status **Ausstehend**, bis dieses konkrete Element korrekt gespeichert oder hochgeladen wurde Das bedeutet, dass die Anfrage normalerweise **Schritt für Schritt** abgeschlossen wird und nicht alles auf einmal. Wenn bei einem Feld oder Upload weiterhin **Ausstehend** angezeigt wird, ist diese Anforderung in der Regel noch nicht abgeschlossen. In vielen Ländern mit Anfrageverfahren kann das Formular Angaben wie diese verlangen: * **Art des Ausweisdokuments** * **Nummer des Ausweisdokuments** * **Geburtsdatum** * **Geburtsort** * **Ausstellende Behörde des Ausweisdokuments** * **Ablaufdatum des Ausweisdokuments** * **Lokale Adresse im selben Land** * **Persönliche Steuernummer** * **Umsatzsteuer-Identifikationsnummer** * **Steuernummer des Unternehmens** * **IT-Kundentyp** * **Adressnachweis** * **Kopie von Reisepass/Ausweis** * **Unternehmensregistrierungszertifikat** Einige Bezeichnungen können außerdem klarstellen, wer welches Element bereitstellen muss, zum Beispiel: * **Nur für juristische Personen** * **Nur für juristische Personen und Einzelunternehmen** * **Nur für natürliche Personen und Einzelunternehmen** Selbst wenn also zwei Kunden Nummern im selben Land anfragen, kann sich die erforderliche Dokumentation je nach Geschäftsart und genauer Nummernkategorie unterscheiden. > **Tipp:** Im Anfrageformular haben einige Felder ihre eigene **Speichern**-Schaltfläche. Das Eingeben eines Werts allein reicht nicht immer aus. Das Element kann weiterhin **Ausstehend** anzeigen, bis Sie erfolgreich auf **Speichern** geklickt haben. ##### Häufige Dokumentationsanforderungen (Beispiele) Die genauen Anforderungen hängen vom Land und vom Nummerntyp ab, aber es können unter anderem folgende Elemente verlangt werden: | Anforderung | Bedeutung | Beispiel | | ------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------ | | Adresse passend zur DID-Vorwahl | Möglicherweise benötigen Sie eine Adresse in derselben Stadt, Region oder im selben Versorgungsbereich wie die angefragte Nummer | „Via Roma 22, Mailand“ für eine lokale Nummer aus Mailand | | Nationaler Ausweis / Steuernummer | Persönliche oder geschäftliche Identifikation zur Validierung des Antragstellers | Reisepassnummer, nationaler Ausweis, Steuernummer, USt-IdNr. | | Kontaktinformationen | Eine erreichbare Person oder ein erreichbarer Unternehmenskontakt für die Anfrage | „Luca Bianchi, +39 345 000 1111“ | | Adressnachweis (Upload) | Ein Dokument, das die in der Anfrage eingetragene Adresse zeigt | Strom- oder Gasrechnung, Kontoauszug, Mietvertrag oder offizielles Behördenschreiben | | Kopie von Reisepass/Ausweis (Upload) | Identitätsprüfung für eine Privatperson oder einen Unternehmensvertreter | Reisepass-Scan oder Vorder-/Rückseitenkopie des Ausweises | | Unternehmensnachweis (Upload) | Nachweis, dass das Unternehmen rechtlich registriert ist | Gründungsurkunde, Handelsregisterauszug | | Steuernummer des Unternehmens / Umsatzsteuer-Identifikationsnummer | Steuerinformationen des Unternehmens für geschäftliche Anfragen | Umsatzsteuer-Identifikationsnummer oder Unternehmenssteuernummer | | Geburtsdatum und Geburtsort | Persönliche Identifikationsdaten, die in einigen Ländern erforderlich sind | „14. März 1988, Neapel“ | | Ausstellende Behörde und Ablaufdatum des Ausweisdokuments | Informationen zur ausstellenden Behörde und zur Gültigkeit des Dokuments | „Ausgestellt von Comune di Torino, Ablauf 08/2028“ | ##### Adressnachweis: was am häufigsten Probleme verursacht Das Dokument für den **Adressnachweis** ist einer der häufigsten Gründe dafür, dass sich eine Anfrage verzögert. In vielen Ländern muss der hochgeladene Adressnachweis alle folgenden Bedingungen erfüllen: * Er muss deutlich denselben **Namen** zeigen, der in der Anfrage verwendet wurde, oder den Firmennamen, wenn es sich um eine Unternehmensanfrage handelt * Er muss deutlich dieselbe **Adresse** zeigen, die im Formular eingetragen wurde * Er muss **aktuell** sein * Er muss vollständig und gut lesbar sein * Er darf nicht so zugeschnitten sein, dass wichtige Details fehlen Eine sehr wichtige Regel ist, dass die Rechnung oder das Adressdokument zum Zeitpunkt der Einreichung oft **nicht älter als 3 Monate** sein darf. Das bedeutet in der Regel, dass Sie ein aktuelles Dokument hochladen sollten, zum Beispiel: * Eine Versorgungsrechnung aus den letzten 3 Monaten * Einen Kontoauszug aus den letzten 3 Monaten * Ein offizielles Behörden- oder Steuerschreiben aus den letzten 3 Monaten Ältere Dokumente können abgelehnt werden, selbst wenn die Adresse korrekt ist. > **Wichtig:** Wenn Sie eine Rechnung oder einen Kontoauszug als Adressnachweis hochladen, stellen Sie sicher, dass das Dokument **weniger als 3 Monate alt** ist. Wenn das Dokument älter ist, kann die Anfrage ausstehend bleiben oder während der Prüfung abgelehnt werden. ##### So bereiten Sie Dokumente vor dem Upload vor Um Verzögerungen zu vermeiden, prüfen Sie jedes Dokument, bevor Sie es hochladen. Ein gutes Dokument sollte sein: * **Klar und lesbar** * **Vollständig**, ohne abgeschnittene Ränder * **Konsistent** mit den im Formular eingetragenen Daten * **Aktuell**, besonders bei Adressnachweisen * **Passend** zum Antragstellertyp, egal ob Privatperson oder Unternehmen Wenn die Anfrage zum Beispiel für ein Unternehmen gestellt wird, kann der Prüfer erwarten, dass Firmenname, Registrierungsnummer, Steuerangaben und Unternehmensdokumente zueinander passen. Wenn die Anfrage für eine Privatperson gestellt wird, kann der Prüfer kontrollieren, ob persönlicher Name, Ausweisdokument und Adressnachweis übereinstimmen. Häufige Probleme, die die Genehmigung verzögern können, sind unter anderem: * Die Adresse im Formular stimmt nicht mit der im hochgeladenen Dokument überein * Die hochgeladene Rechnung ist älter als 3 Monate * Die Kopie des Reisepasses oder Ausweises ist unscharf * Eine Unternehmensanfrage wird nur mit persönlichen Dokumenten eingereicht * Ein Feld wurde ausgefüllt, aber der Benutzer hat nicht auf **Speichern** geklickt * Ein Dokument wurde hochgeladen, aber der Status zeigt weiterhin **Ausstehend** an > **Häufiger Fehler:** Das Hochladen der richtigen Datei reicht nicht immer aus. Prüfen Sie nach jedem Upload oder jeder Texteingabe, dass bei der Anforderung nicht mehr **Ausstehend** angezeigt wird. ##### Gebühren + Prüfung Einige Länder zeigen nach Abschluss der Dokumentation einen Schritt zur **Gebührenzahlung** an. Dieser kann Folgendes umfassen: * Eine **einmalige Aktivierungsgebühr** * Die **monatlich wiederkehrenden Kosten** der Nummer Die Anfrage wird in der Regel erst weiterbearbeitet, nachdem die erforderlichen Dokumente hochgeladen und der Zahlungsschritt abgeschlossen wurden. Nach dem Absenden und Bezahlen: * Sie erhalten eine **Anfrage-ID** * Die Anfrage wird von einem Betreiber geprüft * Nach der Genehmigung erscheint die Nummer in Ihrer Numbers-Liste Die Prüfung erfolgt in vielen Fällen manuell, daher ist die Genehmigung nicht immer sofort verfügbar. > **Wichtig:** Die Genehmigungsdauer kann je nach Land, Anbieterregeln und Qualität der Dokumentation variieren. Wenn Sie die Nummer für einen bevorstehenden Start oder eine Kampagne benötigen, senden Sie die Anfrage so früh wie möglich ab und verwenden Sie aktuelle, gut lesbare Dokumente. *** ### Option B: Nummern von Twilio importieren Wenn Sie bereits Nummern bei Twilio haben, können Sie diese in Callin.io importieren: 1. Gehen Sie zu [Nummern öffnen](https://app.callin.io/numbers). 2. Klicken Sie auf die Hinzufügen-Aktion und wählen Sie den Twilio-Import. 3. Geben Sie Ihre Twilio-Konto-ID und Ihr Twilio-Authentifizierungstoken ein. 4. Starten Sie die Suche nach Twilio-Nummern und wählen Sie die zu importierenden Nummern aus. 5. Weisen Sie importierte Nummern einem Agenten zu, sobald Sie sie verwenden möchten. > **Häufiger Fehler:** Falsche Twilio-Zugangsdaten (zum Beispiel das falsche Projekt). Wenn keine Nummern angezeigt werden, prüfen Sie ID, Token sowie das richtige Konto bzw. Unterkonto. *** ### Option C: Eine persönliche Nummer hinzufügen (nur ausgehende Anrufe) Eine **persönliche Nummer** ist praktisch, um ausgehende Anrufe mit Ihrer eigenen Nummer zu tätigen, hat aber eine wichtige Einschränkung: * **Nur für ausgehende Anrufe** * **Kann keine eingehenden Anrufe** in Callin.io empfangenScreenshot: Persönliche Nummer hinzufügen mit Verifizierungsablauf (Sie erhalten einen Anruf und geben den Code ein).
#### So verifizieren Sie Ihre persönliche Nummer 1. Gehen Sie zu [Nummern öffnen](https://app.callin.io/numbers). 2. Klicken Sie auf die Hinzufügen-Aktion und wählen Sie die Option für persönliche Nummern. 3. Wählen Sie das Land und geben Sie Ihre Nummer ein. 4. Starten Sie die Verifizierung. 5. Sie erhalten einen **Verifizierungsanruf**. 6. Geben Sie den Code ein, wenn Sie dazu aufgefordert werden. 7. Nach der Verifizierung wird die Nummer Ihrem Konto hinzugefügt. > **Wichtig:** Für eingehende Anrufe benötigen Sie eine gekaufte/importierte Nummer oder BYOC (SIP Trunk). *** ### Option D: Telnyx-Nummern hinzufügen/importieren Wenn Sie Telnyx bereits verbunden haben (über BYOC), können Sie aktive Nummern importieren: 1. Gehen Sie zu [Nummern öffnen](https://app.callin.io/numbers). 2. Klicken Sie auf die Hinzufügen-Aktion und wählen Sie die Telnyx-Option. 3. Wählen Sie die Nummern aus, die Sie hinzufügen/importieren möchten. 4. Bestätigen Sie und weisen Sie sie bei Bedarf Ihren Agenten zu. *** ### Eine Nummer einem Agenten zuweisen Der Kauf oder Import ist nicht immer der letzte Schritt. Achten Sie in der Nummernliste auf Hinweise wie: * Nummer ist keinem Agenten zugewiesen Wenn das erscheint, weisen Sie die Nummer vor echten Anrufen dem richtigen Agenten zu. > **Tipp:** Halten Sie eine „Testnummer“ getrennt von der Produktionsnummer, solange Sie Anweisungen und Anrufabläufe optimieren. *** ## BYOC (SIP Trunk) BYOC (Bring Your Own Carrier) ermöglicht es Ihnen, Ihren eigenen Telefonieanbieter über einen **SIP Trunk** zu verbinden, statt Nummern zu verwenden, die von Callin.io verwaltet werden. Öffnen Sie die Einrichtung hier: [BYOC öffnen](https://app.callin.io/byoc)Screenshot: BYOC-Bereich zum Verbinden von Telnyx, Synchronisieren von DIDs und Bereitstellen des SIP Trunk.
### Was ist ein SIP Trunk (einfach erklärt) Ein **SIP Trunk** ist eine „Telefonie-über-Internet“-Verbindung zwischen Ihrem Carrier und Ihrem Anrufsystem. In Unternehmen wird das häufig genutzt, um ein- und ausgehende Anrufe zu steuern, inklusive Routing, SBC, Zugangsdaten und Richtlinien. *** ### Option 1: Telnyx verbinden Wenn Sie Telnyx nutzen, führt Callin.io Sie mit einem API-Schlüssel durch den Prozess: 1. Gehen Sie zu [BYOC öffnen](https://app.callin.io/byoc). 2. Öffnen Sie den Telnyx-Tab. 3. Fügen Sie Ihren Telnyx-API-Schlüssel ein. 4. Starten Sie die Einrichtung. Währenddessen sehen Sie typischerweise Schritte wie: * Telnyx-API-Schlüssel speichern * Aktive Nummern (DIDs) abrufen * Nummern in Ihrem Konto speichern * SIP Trunk bereitstellen (eingehend und ausgehend) Am Ende sollten Ihre Telnyx-Nummern in Nummern erscheinen. > **Wichtig:** Wenn Ihr API-Schlüssel nicht die nötigen Berechtigungen zum Lesen von DIDs/Nummern hat, kann Callin.io sie nicht importieren. *** ### Option 2: Anderen Anbieter verbinden (generischer SIP-Trunk) Wenn Ihr Anbieter nicht Telnyx ist, nutzen Sie den Tab für einen anderen SIP-Anbieter. Üblicherweise sehen Sie drei Bereiche: **Basis**, **Eingehend** und **Ausgehend**. #### Basis * **Bezeichnung**: ein sprechender Name (Beispiel: “HQ SIP Trunk”) * **Nummer im E.164-Format**: vollständiges internationales Format (Beispiel: `+15551234567`) * Optionen zur Unterstützung eingehender und ausgehender Anrufe #### Eingehend * **Eingehender SBC/FQDN**: SIP-Zieladresse (Beispiel: `sip.example.com:5061`) * **Transport**: meist TLS oder UDP * **Medienverschlüsselung**: aktivieren, falls unterstützt > **Tipp:** Für eingehende Anrufe werden oft keine Zugangsdaten benötigt. Viele Carrier authentifizieren über Trunk-Konfiguration oder erlaubte IPs. #### Ausgehend * **Ausgehender SBC/FQDN**: SIP-Server des Anbieters * **Transport** und **Medienverschlüsselung** * **Benutzername** und **Passwort**: SIP-Zugangsdaten * **Erlaubte Länder (ausgehend)**: zum Beispiel weltweit oder benutzerdefinierte Liste Wenn alles ausgefüllt ist, speichern und importieren Sie. > **Häufiger Fehler:** Falscher SBC/FQDN oder falsche Zugangsdaten. Wenn ausgehende Anrufe scheitern, prüfen Sie Benutzername/Passwort, Transport und die vom Anbieter geforderten Ports. *** ## Minuten und Abrechnung (das Wichtigste) Die Abrechnung besteht meist aus zwei Teilen: * **Callin-Nutzung (compute minutes)**: Zeit, in der der Agent aktiv ist (hört zu, verarbeitet, antwortet). * **Telefoniekosten**: abhängig davon, wie Sie die Nummer verbinden und welcher Anbieter genutzt wird. ### Wichtiger Abrechnungshinweis (erste Minute) Wenn Sie Anrufe über Telefonie tätigen, die über den Anbieter von Callin geroutet wird (zum Beispiel Nummern, die über Callin.io gekauft wurden), kann eine Regel zur **Abrechnung der ersten Minute** gelten: * Mindestabrechnung ist **1 Minute** * Dauert der Anruf länger als eine Minute, folgt die Abrechnung nach der ersten Minute der tatsächlichen Dauer (keine Zusatzkosten über das Minimum hinaus) Außerdem gilt beim Kauf einer Telnyx/Twilio-Nummer über Callin.io: * **Es wird keine zusätzliche Plattformgebühr allein für die Nummer berechnet** Diese Regel zur ersten Minute gilt in der Regel nicht für: * Testanrufe im Browser * Importierte Nummern (Twilio oder Telnyx) * Externer SIP-Trunk (BYOC) > **Wichtig:** Das genaue Verhalten kann je nach Routing-Konfiguration Ihres Kontos variieren. Wenn Sie Regeln vermeiden möchten, die an einen von Callin verwalteten Anbieter gekoppelt sind, nutzen Sie importierte Nummern oder BYOC (SIP Trunk). ### Hinweis: Abrechnung bei persönlicher Nummer Eine **persönliche Nummer** ist **nur für ausgehende Anrufe** und kann je nach Routing in den Abrechnungsbereich des Callin-Anbieters fallen. > **Wichtig:** Auch wenn Sie eine persönliche Nummer für ausgehende Anrufe nutzen, benötigen Sie für eingehende Anrufe eine gekaufte/importierte Nummer oder BYOC (SIP Trunk). *** ## Fehlerbehebung ### „Ich kann keine Anrufe tätigen“ * Stellen Sie sicher, dass mindestens **eine aktive Nummer** vorhanden ist * Prüfen Sie, ob die Nummer einem **Agenten zugewiesen** ist * Wenn Sie BYOC (SIP Trunk) nutzen, prüfen Sie **SBC/FQDN**, Transport, Medienverschlüsselung und Zugangsdaten ### „Meine persönliche Nummer erhält keine eingehenden Anrufe“ * Das ist normal: eine **persönliche Nummer ist nur für ausgehende Anrufe** * Nutzen Sie eine gekaufte/importierte Nummer oder BYOC (SIP Trunk) für eingehende Anrufe ### „Meine importierten Nummern werden nicht angezeigt“ * Prüfen Sie die Zugangsdaten (Twilio Account SID/Auth Token oder Telnyx-API-Schlüssel) * Bestätigen Sie, dass die Nummern beim Anbieter aktiv sind * Stellen Sie sicher, dass Sie das richtige Konto/Unterkonto verwenden *** ## Abschließende Notiz Wenn Sie die schnellste Einrichtung möchten, starten Sie mit einer Nummer für **USA oder Kanada**, die Sie über Callin.io kaufen. Wenn Sie bereits einen Carrier haben oder mehr Routing-Kontrolle benötigen, verbinden Sie BYOC (SIP Trunk). Sobald die Nummer hinzugefügt und zugewiesen ist, können Ihre KI-Agenten echte Anrufe in großem Umfang tätigen und entgegennehmen. # Numeros y BIOC Source: https://support.callin.io/Create-AI-Agent/Configure-Numbers-copied-2 Aprende a comprar, importar o verificar números telefónicos y a conectar BYOC (SIP Trunk) para que tus agentes de IA puedan hacer y recibir llamadas. ## Descripción general Los números telefónicos son el puente entre tus agentes de IA y las llamadas reales. En Callin.io, lo gestionarás en dos lugares: * **Números**: Compra números a través de Callin.io, importa desde proveedores o verifica un número personal. * **BYOC (SIP Trunk)**: Trae tu propio carrier conectando Telnyx o cualquier proveedor SIP. Usa estos accesos directos para abrir cada sección en la app: * Ir a **Números**: [Abrir Números](https://app.callin.io/numbers) * Ir a **BYOC (SIP Trunk)**: [Abrir BYOC](https://app.callin.io/byoc) > **Consejo:** Si quieres empezar rápido, compra un número de **Estados Unidos o Canadá** (normalmente es instantáneo). Si necesitas un número internacional, prepárate para aportar datos y subir documentación (las reglas varían según el país). *** ## Números La página de **Números** muestra todos los números conectados a tu workspace (comprados, importados, personal, Telnyx o BYOC). Desde aquí puedes añadir números nuevos, revisar el estado y ver avisos importantes (por ejemplo, si un número aún no está asignado a ningún agente).Captura: La página de Números, con filtros por proveedor y el menú + Add Number para comprar o importar números.
### Qué puedes hacer desde Números Al pulsar **+ Add Number**, normalmente verás opciones como (el texto puede variar según tu cuenta/plan): * **Purchase Number** (comprar a través de Callin.io) * **Import from Twilio** * **Add Personal Number** * **Add Telnyx Number** (después de conectar Telnyx) También suelen aparecer filtros como **Purchased**, **Twilio**, **Personal**, **Telnyx** y **BYOC (SIP Trunk)** para localizar rápidamente cada tipo de número. *** ### Opción A: Comprar un número a través de Callin.io Comprar números a través de Callin.io es la forma más directa de empezar. #### Estados Unidos y Canadá: compra instantánea Para **Estados Unidos** y **Canadá**, el flujo de compra suele ser rápido e inmediato: 1. Ve a [Abrir Números](https://app.callin.io/numbers). 2. Pulsa **+ Add Number** → **Purchase Number**. 3. Elige el **Country**. 4. Elige el tipo: * **Local** * **Toll-Free** (si está disponible) 5. (Opcional) Usa **Search by Area Code** (ejemplo: `415`). 6. Pulsa **Search Numbers**. 7. Selecciona un número de la lista. 8. Pulsa **Purchase Selected Number**. > **Importante:** Si ves un aviso como “this number is not assigned to any agent”, el número todavía no está listo para usarse: primero tienes que asignarlo a un agente. #### Otros países: solicitud + documentaciónCaptura: después de iniciar la solicitud, la plataforma carga los campos y documentos específicos del país que debes completar antes del pago y la revisión.
Para muchos países **fuera de EE. UU./Canadá**, la compra sigue un flujo **basado en solicitud** en lugar de una compra instantánea. * Seleccionas el país y el tipo de número (por ejemplo, **Local** o **Móvil**). * Puedes ver opciones de **Tipo de solicitud** como **Nuevo número** y **Portabilidad**. * Eliges uno de los números disponibles y haces clic en **Iniciar solicitud**. * La plataforma carga entonces la información y los requisitos de documentación **específicos del país**. * Debes completar los campos obligatorios, subir documentos y guardar cada elemento. * Envías la solicitud, pagas las tarifas requeridas y luego la solicitud es revisada por un operador. Normalmente puedes seguir estas solicitudes en una pestaña como **Solicitudes de números**. Esta parte del proceso es importante porque los requisitos no siempre son los mismos. Pueden cambiar según el **país**, el **tipo de número** y si la solicitud la realiza un **particular**, un **autónomo** o una **empresa**. ##### Cómo funciona el paso de documentación Después de hacer clic en **Iniciar solicitud**, el formulario puede mostrar una combinación de: * Campos de texto que debes completar manualmente * Campos de carga para documentos de respaldo * Un botón **Guardar** para cada requisito individual * Un estado **Pendiente** hasta que ese elemento específico se guarde o suba correctamente Esto significa que la solicitud normalmente se completa **pieza por pieza**, no toda de una sola vez. Si un campo o una carga sigue mostrando **Pendiente**, ese requisito normalmente todavía no está completo. En muchos países con solicitud previa, el formulario puede pedir datos como: * **Tipo de documento de identidad** * **Número de documento de identidad** * **Fecha de nacimiento** * **Lugar de nacimiento** * **Emisor del documento de identidad** * **Fecha de caducidad del documento de identidad** * **Dirección local en el mismo país** * **Código fiscal personal** * **Número de IVA** * **Código fiscal de la empresa** * **Tipo de cliente IT** * **Comprobante de domicilio** * **Copia de pasaporte/DNI** * **Certificado de registro de la empresa** Algunas etiquetas también pueden aclarar quién debe aportar cada elemento, por ejemplo: * **Solo para entidades legales** * **Solo para entidades legales y autónomos** * **Solo para personas físicas y autónomos** Así que, incluso si dos clientes solicitan números en el mismo país, la documentación requerida puede variar según el tipo de empresa y la categoría exacta del número. > **Consejo:** En el formulario de solicitud, algunos campos tienen su propio botón **Guardar**. Introducir un valor no siempre es suficiente por sí solo. El elemento puede seguir mostrando **Pendiente** hasta que hagas clic en **Guardar** correctamente. ##### Requisitos documentales habituales (ejemplos) Los requisitos exactos dependen del país y del tipo de número, pero es posible que te pidan elementos como estos: | Requisito | Qué significa | Ejemplo | | ------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------ | | Dirección que coincida con el código de área DID | Puede que necesites una dirección en la misma ciudad, región o zona de cobertura del número que estás solicitando | “Via Roma 22, Milán” para un número local de Milán | | Documento nacional de identidad / Número fiscal | Identificación personal o empresarial utilizada para validar al solicitante | Número de pasaporte, documento nacional de identidad, código fiscal, número de IVA | | Información de contacto | Una persona o contacto de empresa localizable para la solicitud | “Luca Bianchi, +39 345 000 1111” | | Comprobante de domicilio (subida) | Un documento que muestre la dirección que introdujiste en la solicitud | Factura de servicios, extracto bancario, contrato de alquiler o carta oficial del gobierno | | Copia de pasaporte/DNI (subida) | Verificación de identidad para un particular o un representante de la empresa | Escaneo del pasaporte o copia del DNI por ambas caras | | Certificado empresarial (subida) | Prueba de que la empresa está registrada legalmente | Certificado de constitución, extracto del registro mercantil | | Código fiscal de la empresa / Número de IVA | Información fiscal de la empresa para solicitudes corporativas | Número de IVA o número fiscal de la empresa | | Fecha y lugar de nacimiento | Datos de identificación personal requeridos en algunos países | “14 de marzo de 1988, Nápoles” | | Emisor y fecha de caducidad del documento de identidad | Información sobre la autoridad emisora y la validez del documento | “Emitido por Comune di Torino, caduca en 08/2028” | ##### Comprobante de domicilio: lo que suele causar problemas El documento de **comprobante de domicilio** es una de las razones más comunes por las que una solicitud se retrasa. En muchos países, el comprobante de domicilio que subas debe cumplir todas estas condiciones: * Debe mostrar claramente el **mismo nombre** utilizado en la solicitud, o el nombre de la empresa si la solicitud es empresarial * Debe mostrar claramente la **misma dirección** introducida en el formulario * Debe ser **reciente** * Debe estar completo y ser legible * No debe estar recortado de forma que oculte detalles importantes Una regla muy importante es que la factura o el documento de domicilio normalmente debe tener **menos de 3 meses de antigüedad** en el momento del envío. Eso normalmente significa que debes subir un documento reciente como: * Una factura de servicios emitida en los últimos 3 meses * Un extracto bancario emitido en los últimos 3 meses * Una carta oficial del gobierno o de impuestos emitida en los últimos 3 meses Los documentos más antiguos pueden ser rechazados aunque la dirección sea correcta. > **Importante:** Cuando subas una factura o un extracto bancario como comprobante de domicilio, asegúrate de que tenga **menos de 3 meses de antigüedad**. Si el documento es más antiguo, la solicitud puede seguir pendiente o ser rechazada durante la revisión. ##### Cómo preparar los documentos antes de subirlos Para evitar retrasos, revisa cada documento antes de subirlo. Un buen documento debe ser: * **Claro y legible** * **Completo**, sin bordes cortados * **Coherente** con los datos introducidos en el formulario * **Actual**, especialmente en el caso de los comprobantes de domicilio * **Adecuado** para el tipo de solicitante, ya sea particular o empresa Por ejemplo, si la solicitud es para una empresa, el revisor puede esperar que el nombre de la empresa, el número de registro, los datos fiscales y los documentos de constitución coincidan entre sí. Si la solicitud es para un particular, el revisor puede comprobar que el nombre personal, el documento de identidad y el comprobante de domicilio coincidan. Problemas habituales que pueden retrasar la aprobación: * La dirección del formulario no coincide con la del documento subido * La factura subida tiene más de 3 meses de antigüedad * La copia del pasaporte o del DNI está borrosa * Se envía una solicitud de empresa solo con documentos personales * Un campo está completado, pero el usuario no hizo clic en **Guardar** * Se subió un documento, pero su estado sigue mostrando **Pendiente** > **Error común:** Subir el archivo correcto no siempre es suficiente. Después de cada carga o entrada de texto, comprueba que el requisito ya no muestre **Pendiente**. ##### Tarifas + revisión Algunos países muestran un paso de **pago de tarifas** después de completar la documentación. Esto puede incluir: * Una **tarifa única de activación** * El **coste mensual recurrente** del número La solicitud normalmente avanza solo después de que se hayan subido los documentos requeridos y se haya completado el paso de pago. Después de enviar y pagar: * Recibirás un **ID de solicitud** * La solicitud será revisada por un operador * Una vez aprobada, el número aparecerá en tu lista de Numbers La revisión es manual en muchos casos, por lo que la aprobación no siempre es inmediata. > **Importante:** El tiempo de aprobación puede variar según el país, las reglas del proveedor y la calidad de la documentación. Si necesitas el número para un lanzamiento o una campaña próxima, envía la solicitud lo antes posible y utiliza documentos recientes y claramente legibles. *** ### Opción B: Importar números desde Twilio Si ya tienes números en Twilio, puedes importarlos a Callin.io: 1. Ve a [Abrir Números](https://app.callin.io/numbers). 2. Pulsa **+ Add Number** → **Import from Twilio**. 3. Introduce tu **Twilio Account SID** y **Twilio Auth Token**. 4. Pulsa **Search Twilio Numbers** y selecciona los números a importar. 5. Asigna los números importados a un agente cuando quieras usarlos. > **Error común:** Usar credenciales equivocadas (por ejemplo, del proyecto incorrecto). Si no aparece ningún número, revisa el SID/Token y que estés en la cuenta/subcuenta correcta. *** ### Opción C: Añadir un número personal (solo outbound) Un **Personal Number** es útil para hacer llamadas salientes desde tu propio número, pero tiene una limitación clave: * **Solo sirve para outbound** * **No puede recibir llamadas inbound** dentro de Callin.ioCaptura: Modal de Add Personal Number con el flujo de verificación (recibes una llamada y completas el código).
#### Cómo verificar tu número personal 1. Ve a [Abrir Números](https://app.callin.io/numbers). 2. Pulsa **+ Add Number** → **Add Personal Number**. 3. Elige el país e introduce tu número. 4. Pulsa **Verify Number**. 5. Recibirás una **llamada de verificación**. 6. Introduce el código cuando se te indique. 7. Tras la verificación, el número se añade a tu cuenta. > **Importante:** Si necesitas inbound, usa un número comprado/importado o BYOC (SIP Trunk). *** ### Opción D: Añadir/Importar números de Telnyx Si ya conectaste Telnyx (desde BYOC), podrás importar tus números activos: 1. Ve a [Abrir Números](https://app.callin.io/numbers). 2. Pulsa **+ Add Number** → **Add Telnyx Number**. 3. Selecciona los números que quieres añadir/importar. 4. Confirma y asígnalos a tus agentes cuando lo necesites. *** ### Asignar un número a un agente Comprar o importar el número no siempre es el último paso. En la lista de Números, presta atención a avisos como: * “this number is not assigned to any agent” Si aparece, asigna el número al agente correcto antes de hacer llamadas reales. > **Consejo:** Mantén un número “de pruebas” separado del número de producción mientras ajustas prompts y flujos. *** ## BYOC (SIP Trunk) BYOC (Bring Your Own Carrier) te permite usar tu propio proveedor de telefonía conectándolo mediante un **SIP Trunk**, en lugar de depender de números gestionados por Callin.io. Ve directamente a la configuración aquí: [Abrir BYOC](https://app.callin.io/byoc)Captura: Pantalla de BYOC para conectar Telnyx, sincronizar DIDs y aprovisionar el SIP Trunk.
### Qué es un SIP Trunk (en sencillo) Un **SIP Trunk** es una conexión “de telefonía por internet” entre tu carrier y tu sistema de llamadas. Se usa mucho en empresas para gestionar inbound/outbound con control de routing, SBC, credenciales y políticas. *** ### Opción 1: Conectar Telnyx Si usas Telnyx, Callin.io guía el proceso con una API key: 1. Ve a [Abrir BYOC](https://app.callin.io/byoc). 2. Abre la pestaña **Telnyx**. 3. Pega tu **Telnyx API Key**. 4. Pulsa **Start**. Durante el proceso suelen aparecer pasos como: * Guardar la Telnyx API key * Obtener números activos (DIDs) * Guardar números en tu cuenta * Aprovisionar el SIP Trunk (inbound y outbound) Al finalizar, tus números de Telnyx deberían aparecer en Números. > **Importante:** Si tu API key no tiene permisos para leer DIDs/números, Callin.io no podrá importarlos. *** ### Opción 2: Conectar otro proveedor (Generic SIP Trunk) Si tu proveedor no es Telnyx, usa la pestaña **Other SIP Provider**. Normalmente verás tres secciones: **Basic**, **Inbound** y **Outbound**. #### Basic * **Label**: Un nombre descriptivo (ejemplo: “HQ SIP Trunk”) * **Phone Number (E.164)**: Formato internacional completo (ejemplo: `+15551234567`) * Opciones como **Supports inbound** y **Supports outbound** #### Inbound * **Inbound SBC / FQDN**: Dirección SIP destino (ejemplo: `sip.example.com:5061`) * **Transport**: normalmente **TLS** o **UDP** * **Media encryption**: actívalo si tu proveedor lo soporta > **Consejo:** En inbound, a menudo no se usan credenciales. Muchos carriers autentican por configuración del trunk o allowlist. #### Outbound * **Outbound SBC / FQDN**: servidor SIP del proveedor * **Transport** y **Media encryption** * **Username** y **Password**: credenciales SIP * **Allowed countries (outbound)**: por ejemplo **Worldwide** o **Custom list** Cuando termines, pulsa **Save & Import**. > **Error común:** Un SBC/FQDN incorrecto o credenciales erróneas. Si outbound falla, revisa usuario/contraseña, transport y puertos requeridos por tu proveedor. *** ## Minutos y facturación (lo más importante) La facturación suele tener dos partes: * **Uso de Callin (compute minutes)**: tiempo en el que el agente está activo (escucha, procesa y responde). * **Costes de telefonía**: dependen de cómo conectes el número y del carrier que use tu cuenta. ### Aviso de facturación importante (primer minuto) Cuando realizas llamadas usando telefonía enruta a través del carrier de Callin (por ejemplo, números comprados a través de Callin.io), puede aplicarse una regla de **first-minute billing**: * El cobro mínimo es **1 minuto** * Si la llamada dura más de 1 minuto, después del primer minuto la facturación sigue la duración real (sin cargos extra más allá del mínimo) Además, cuando compras un número de Telnyx/Twilio a través de Callin.io: * **No se añade una tarifa extra de plataforma por el número en sí** Esta regla de primer minuto normalmente **no aplica** a: * **Browser test calls** * Números importados (Twilio o Telnyx) * **External SIP trunk** (BYOC / bring your own carrier) > **Importante:** El comportamiento exacto puede variar según cómo esté configurado el routing de tu cuenta. Si quieres evitar reglas asociadas a carrier gestionado por Callin, usa números importados o BYOC (SIP Trunk). ### Recordatorio: facturación en Personal Number Un **Personal Number** es **solo outbound**, y puede estar dentro del alcance de la facturación del carrier de Callin según cómo se enruten tus llamadas. > **Importante:** Aunque uses Personal Number para outbound, para inbound necesitas un número comprado/importado o BYOC (SIP Trunk). *** ## Solución de problemas ### “No puedo hacer llamadas” * Confirma que tienes al menos **un número activo** * Revisa si el número está **asignado a un agente** * Si usas BYOC (SIP Trunk), valida **SBC/FQDN**, **Transport**, **Media encryption** y credenciales ### “Mi Personal Number no recibe llamadas inbound” * Es lo esperado: **Personal Number es solo outbound** * Usa un número comprado/importado o BYOC (SIP Trunk) para inbound ### “Mis números importados no aparecen” * Revisa credenciales (Twilio Account SID/Auth Token o Telnyx API Key) * Confirma que los números estén activos en el proveedor * Verifica que estás usando la cuenta/subcuenta correcta *** ## Nota final Si buscas la configuración más rápida, empieza con un número de **Estados Unidos o Canadá** comprado a través de Callin.io. Si ya tienes carrier o necesitas más control de routing, conecta BYOC (SIP Trunk). Cuando el número esté añadido y asignado, tus agentes de IA podrán hacer y recibir llamadas reales a escala. # Cronologia chiamate Source: https://support.callin.io/Create-AI-Agent/Configure-Numbers-copied-3 Filtra, esporta e analizza le chiamate passate. Apri i dettagli di una chiamata per consultare la registrazione, la trascrizione e gli insight, e scaricare l’audio quando disponibile. ## Panoramica **Cronologia chiamate** è la sezione in cui rivedi le chiamate passate del tuo workspace. Da questa pagina puoi: * **Cercare e filtrare** le chiamate (per numero di telefono, agente, stato, intervallo di date e altro) * **Vedere gli esiti della chiamata** (ad esempio, se è stato rilevato un appuntamento o la segreteria) * **Esportare** l’elenco corrente in **CSV** * **Aprire i dettagli della chiamata** per analizzare la conversazione (registrazione, trascrizione, riepilogo, momenti chiave, sentiment) * **Scaricare** la registrazione della chiamata (quando disponibile) Usa questo link diretto per aprire la pagina: [Apri la cronologia chiamate](https://app.callin.io/call-history) > **Suggerimento:** Salva il link tra i preferiti se consulti le chiamate ogni giorno. ## Aprire la cronologia chiamate 1. Nella barra laterale sinistra, vai alla sezione **Valutazione**. 2. Clicca su **Cronologia chiamate**. ## Filtrare e cercare le chiamate In alto nella pagina vedrai in genere due azioni principali: * **Filtri** (per restringere l’elenco) * **Esporta CSV** (per scaricare i risultati) L’area dei filtri include campi come i seguenti (la disponibilità può variare in base ad account/piano): | Filtro | A cosa serve | Esempio | | ---------------------- | ------------------------------------------------- | ---------------------- | | Numero di telefono | Trovare chiamate di un numero specifico | Cerca “+1 415…” | | ID chiamata | Aprire una chiamata specifica | Incolla un ID chiamata | | Agente assegnato | Vedere le chiamate gestite da un agente | “Agente vendite 1” | | Stato | Filtrare per stato della chiamata | “Completata” | | Direzione | Separare entrate e uscite | “In entrata” | | Intervallo di date | Concentrarsi su un periodo | “Ultimi 7 giorni” | | Durata della chiamata | Filtrare per durata | “Oltre 1 minuto” | | Origine della chiamata | Identificare da dove arriva la chiamata | “Applicazione” | | ID campagna | Filtrare per identificatore campagna | Incolla un ID | | Appuntamento | Trovare chiamate con appuntamento rilevato | “Tutti” / filtrato | | Trasferimento chiamata | Trovare chiamate con trasferimenti | “Tutti” / filtrato | | Macchina | Trovare chiamate con segreteria/macchina rilevata | “Tutti” / filtrato | > **Errore comune:** Applicare troppi filtri insieme può non restituire risultati. Se la tabella è vuota, rimuovi un filtro e riprova.Screenshot: usa il pannello dei filtri per restringere l’elenco prima di esportare o aprire i dettagli di una chiamata.
## Capire gli esiti della chiamata (icone) Nella tabella delle chiamate potresti vedere una colonna di **esiti della chiamata** con icone che riassumono cosa è stato rilevato durante la chiamata. * **Icona calendario**: è stato rilevato un **appuntamento** per quella chiamata. * Se passi il mouse sopra l’icona del calendario, vedrai i dettagli dell’appuntamento. * **Icona testa di robot**: è stata rilevata una **segreteria / risposta automatica** (l’agente ha identificato una segreteria). > **Importante:** Gli esiti visualizzati possono variare in base a ciò che il sistema rileva per ogni chiamata. ## Esportare la cronologia chiamate in CSV Puoi esportare le chiamate che stai visualizzando (inclusi i filtri applicati). 1. Clicca su **Esporta CSV**. 2. Nella finestra di esportazione, seleziona le **colonne** da includere. * Puoi usare **Seleziona tutto** o **Deseleziona tutto** per fare più in fretta. 3. Clicca su **Esporta CSV** per scaricare il file. > **Suggerimento:** Se vuoi “tutte le chiamate”, rimuovi i filtri prima di esportare. ## Aprire i dettagli della chiamata per analizzarla Per visualizzare tutto su una chiamata specifica: 1. Clicca su una riga della tabella. 2. Si apre un pannello **Dettagli della chiamata** sulla destra. Nei **dettagli della chiamata** puoi consultare e analizzare la conversazione. In base ad account/piano, potresti vedere: * Un lettore della **registrazione della chiamata** (con controlli di riproduzione) * Un menu con opzioni di **velocità di riproduzione** * Schede come: * **Trascrizione della chiamata** * **Riepilogo** * **Momenti chiave** * **Sentiment** * Azioni come **Copia** (ad esempio per copiare la trascrizione o contenuti selezionati) * Opzioni per **scaricare** elementi come la **trascrizione** (la disponibilità può variare) > **Suggerimento:** Usa la ricerca nella trascrizione per trovare rapidamente una frase o un momento preciso. ## Scaricare l’audio della chiamata (registrazione) Per scaricare l’audio di una chiamata (quando è disponibile una registrazione): 1. Clicca su una riga per aprire i **dettagli della chiamata**. 2. Nella scheda **Registrazione della chiamata**, clicca sul menu **tre puntini (… )**. 3. Seleziona **Scarica registrazione**. Nello stesso menu puoi anche regolare la **velocità** (ad esempio 0,5x, 0,75x, 1x, 1,25x, 1,5x, 2x). > **Importante:** Se non vedi **Scarica registrazione**, la registrazione potrebbe non essere disponibile per quella chiamata, oppure l’accesso può variare in base a piano e permessi.Screenshot: apri una chiamata e usa il menu “…” nella registrazione per cambiare la velocità o scaricare l’audio.
# Numéros et BYOC Source: https://support.callin.io/Create-AI-Agent/Configure-Numbers-copied-4 Apprenez à acheter, importer ou vérifier des numéros de téléphone, et à connecter BYOC (SIP Trunk), pour que vos agents IA puissent passer et recevoir des appels. ## Vue d’ensemble Les numéros de téléphone sont le lien entre vos agents IA et les appels réels. Dans Callin.io, vous gérez cela à deux endroits : * **Numéros** : Achetez des numéros via Callin.io, importez depuis des fournisseurs ou vérifiez un numéro personnel. * **BYOC (SIP Trunk)** : Apportez votre propre opérateur en connectant Telnyx ou n’importe quel fournisseur SIP. Utilisez ces raccourcis pour ouvrir chaque section dans l’app : * Aller à **Numéros** : [Ouvrir Numéros](https://app.callin.io/numbers) * Aller à **BYOC (SIP Trunk)** : [Ouvrir BYOC](https://app.callin.io/byoc) > **Conseil :** Pour démarrer vite, achetez un numéro **États-Unis ou Canada** (généralement instantané). Pour un numéro international, préparez-vous à fournir des informations et à téléverser des documents (les règles varient selon le pays). *** ## Numéros La page **Numéros** affiche tous les numéros connectés à votre workspace (achetés, importés, personnel, Telnyx ou BYOC). Depuis ici, vous pouvez ajouter de nouveaux numéros, vérifier leur statut et voir des avertissements importants (par exemple, si un numéro n’est pas encore assigné à un agent).Capture : La page Numéros, avec des filtres par fournisseur et le menu pour acheter ou importer des numéros.
### Ce que vous pouvez faire depuis Numéros En cliquant sur l’action d’ajout (par exemple **+ Ajouter un numéro**), vous verrez généralement des options comme (le libellé peut varier selon votre compte, votre plan ou la langue de l’interface) : * Acheter un numéro via Callin.io * Importer depuis Twilio * Ajouter un numéro personnel * Ajouter un numéro Telnyx (après avoir connecté Telnyx) Vous verrez aussi souvent des filtres par type/provenance (achat, Twilio, personnel, Telnyx, BYOC). *** ### Option A : Acheter un numéro via Callin.io Acheter des numéros via Callin.io est la manière la plus directe de démarrer. #### États-Unis et Canada : achat instantané Pour les **États-Unis** et le **Canada**, le flux d’achat est souvent rapide et immédiat : 1. Allez sur [Ouvrir Numéros](https://app.callin.io/numbers). 2. Cliquez sur l’action d’ajout de numéro, puis choisissez l’option d’achat. 3. Choisissez le **pays**. 4. Choisissez le type : * **Local** * **Numéro gratuit** (si disponible) 5. (Optionnel) Recherchez par **indicatif régional** (exemple : `415`). 6. Lancez la recherche. 7. Sélectionnez un numéro dans la liste. 8. Confirmez l’achat du numéro sélectionné. > **Important :** Si vous voyez un message indiquant que le numéro n’est assigné à aucun agent, il n’est pas encore prêt à être utilisé : vous devez d’abord l’assigner à un agent. #### Autres pays : demande + documentationCapture : après avoir démarré la demande, la plateforme charge les champs et documents spécifiques au pays que vous devez compléter avant le paiement et la révision.
Pour de nombreux pays **hors États-Unis/Canada**, l’achat suit un flux **basé sur une demande** au lieu d’un achat instantané. * Vous sélectionnez le pays et le type de numéro, par exemple **Local** ou **Mobile**. * Vous pouvez voir des options de **Type de demande** comme **Nouveau numéro** et **Portabilité**. * Vous choisissez l’un des numéros disponibles et vous cliquez sur **Démarrer la demande**. * La plateforme charge ensuite les informations et les exigences documentaires **spécifiques au pays**. * Vous devez remplir les champs obligatoires, téléverser les documents et enregistrer chaque élément. * Vous envoyez la demande, payez les frais requis, puis la demande est examinée par un opérateur. Vous pouvez généralement suivre ces demandes dans un onglet comme **Demandes de numéros**. Cette partie du processus est importante, car les exigences ne sont pas toujours les mêmes. Elles peuvent varier selon le **pays**, le **type de numéro** et le fait que la demande soit faite par un **particulier**, une **entreprise individuelle** ou une **société**. ##### Comment fonctionne l’étape de documentation Après avoir cliqué sur **Démarrer la demande**, le formulaire peut afficher une combinaison de : * Champs de texte à remplir manuellement * Champs de téléversement pour les documents justificatifs * Un bouton **Enregistrer** pour chaque exigence individuelle * Un statut **En attente** jusqu’à ce que cet élément précis soit correctement enregistré ou téléversé Cela signifie que la demande est généralement complétée **élément par élément**, et non en une seule fois. Si un champ ou un téléversement affiche encore **En attente**, cette exigence n’est généralement pas encore complétée. Dans de nombreux pays avec demande préalable, le formulaire peut demander des informations comme : * **Type de pièce d’identité** * **Numéro de pièce d’identité** * **Date de naissance** * **Lieu de naissance** * **Autorité émettrice de la pièce d’identité** * **Date d’expiration de la pièce d’identité** * **Adresse locale dans le même pays** * **Code fiscal personnel** * **Numéro de TVA** * **Code fiscal de l’entreprise** * **Type de client IT** * **Justificatif de domicile** * **Copie du passeport/de la pièce d’identité** * **Certificat d’enregistrement de l’entreprise** Certaines mentions peuvent également préciser qui doit fournir chaque élément, par exemple : * **Uniquement pour les personnes morales** * **Uniquement pour les personnes morales et les entreprises individuelles** * **Uniquement pour les personnes physiques et les entreprises individuelles** Ainsi, même si deux clients demandent des numéros dans le même pays, les documents requis peuvent différer selon le type d’activité et la catégorie exacte du numéro. > **Conseil :** Dans le formulaire de demande, certains champs ont leur propre bouton **Enregistrer**. Saisir une valeur ne suffit pas toujours à lui seul. L’élément peut continuer à afficher **En attente** tant que vous n’avez pas cliqué correctement sur **Enregistrer**. ##### Exigences documentaires courantes (exemples) Les exigences exactes dépendent du pays et du type de numéro, mais il peut vous être demandé des éléments comme ceux-ci : | Exigence | Ce que cela signifie | Exemple | | -------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- | | Adresse correspondant à l’indicatif DID | Il peut vous falloir une adresse dans la même ville, région ou zone de couverture que le numéro demandé | « Via Roma 22, Milan » pour un numéro local de Milan | | Pièce d’identité nationale / Numéro fiscal | Identification personnelle ou professionnelle utilisée pour valider le demandeur | Numéro de passeport, pièce d’identité nationale, code fiscal, numéro de TVA | | Coordonnées | Une personne ou un contact d’entreprise joignable pour la demande | « Luca Bianchi, +39 345 000 1111 » | | Justificatif de domicile (téléversement) | Un document indiquant l’adresse saisie dans la demande | Facture de services publics, relevé bancaire, contrat de location ou courrier officiel de l’administration | | Copie du passeport/de la pièce d’identité (téléversement) | Vérification de l’identité d’un particulier ou d’un représentant d’entreprise | Scan du passeport ou copie recto verso de la pièce d’identité | | Certificat d’entreprise (téléversement) | Preuve que l’entreprise est légalement enregistrée | Certificat de constitution, extrait du registre du commerce | | Code fiscal de l’entreprise / Numéro de TVA | Informations fiscales de l’entreprise pour les demandes professionnelles | Numéro de TVA ou numéro fiscal de l’entreprise | | Date et lieu de naissance | Informations d’identification personnelle requises dans certains pays | « 14 mars 1988, Naples » | | Autorité émettrice et date d’expiration de la pièce d’identité | Informations sur l’autorité émettrice et la validité du document | « Délivré par Comune di Torino, expiration 08/2028 » | ##### Justificatif de domicile : ce qui pose le plus souvent problème Le document de **justificatif de domicile** est l’une des raisons les plus courantes pour lesquelles une demande est retardée. Dans de nombreux pays, le justificatif de domicile téléversé doit remplir toutes les conditions suivantes : * Il doit clairement afficher le **même nom** que celui utilisé dans la demande, ou le nom de l’entreprise si la demande est professionnelle * Il doit clairement afficher la **même adresse** que celle saisie dans le formulaire * Il doit être **récent** * Il doit être complet et lisible * Il ne doit pas être recadré de manière à masquer des informations importantes Une règle très importante est que la facture ou le document de domicile doit souvent dater de **moins de 3 mois** au moment de l’envoi. Cela signifie généralement que vous devez téléverser un document récent, par exemple : * Une facture de services publics émise au cours des 3 derniers mois * Un relevé bancaire émis au cours des 3 derniers mois * Un courrier officiel de l’administration ou des impôts émis au cours des 3 derniers mois Les documents plus anciens peuvent être refusés même si l’adresse est correcte. > **Important :** Lorsque vous téléversez une facture ou un relevé bancaire comme justificatif de domicile, assurez-vous qu’il date de **moins de 3 mois**. Si le document est plus ancien, la demande peut rester en attente ou être refusée lors de la révision. ##### Comment préparer les documents avant le téléversement Pour éviter les retards, vérifiez chaque document avant de le téléverser. Un bon document doit être : * **Clair et lisible** * **Complet**, sans bords coupés * **Cohérent** avec les données saisies dans le formulaire * **Récent**, surtout pour les justificatifs de domicile * **Adapté** au type de demandeur, qu’il s’agisse d’un particulier ou d’une entreprise Par exemple, si la demande concerne une entreprise, le réviseur peut s’attendre à ce que le nom de l’entreprise, le numéro d’enregistrement, les informations fiscales et les documents de constitution correspondent entre eux. Si la demande concerne un particulier, le réviseur peut vérifier que le nom personnel, la pièce d’identité et le justificatif de domicile correspondent. Les problèmes courants qui peuvent ralentir l’approbation incluent : * L’adresse du formulaire ne correspond pas à celle du document téléversé * La facture téléversée date de plus de 3 mois * La copie du passeport ou de la pièce d’identité est floue * Une demande d’entreprise est envoyée uniquement avec des documents personnels * Un champ est rempli, mais l’utilisateur n’a pas cliqué sur **Enregistrer** * Un document a été téléversé, mais son statut affiche toujours **En attente** > **Erreur fréquente :** Téléverser le bon fichier ne suffit pas toujours. Après chaque téléversement ou saisie de texte, vérifiez que l’exigence n’affiche plus **En attente**. ##### Frais + révision Certains pays affichent une étape de **paiement des frais** après la finalisation de la documentation. Cela peut inclure : * Des **frais d’activation uniques** * Le **coût mensuel récurrent** du numéro La demande avance généralement uniquement après le téléversement des documents requis et la finalisation de l’étape de paiement. Après l’envoi et le paiement : * Vous recevrez un **ID de demande** * La demande sera examinée par un opérateur * Une fois approuvé, le numéro apparaîtra dans votre liste Numbers La révision est manuelle dans de nombreux cas, c’est pourquoi l’approbation n’est pas toujours immédiate. > **Important :** Le délai d’approbation peut varier selon le pays, les règles du fournisseur et la qualité de la documentation. Si vous avez besoin du numéro pour un lancement ou une campagne à venir, envoyez la demande le plus tôt possible et utilisez des documents récents et clairement lisibles. *** ### Option B : Importer des numéros depuis Twilio Si vous avez déjà des numéros sur Twilio, vous pouvez les importer dans Callin.io : 1. Allez sur [Ouvrir Numéros](https://app.callin.io/numbers). 2. Cliquez sur l’action d’ajout, puis choisissez l’option d’import Twilio. 3. Saisissez votre identifiant de compte Twilio et votre jeton d’authentification Twilio. 4. Lancez la recherche des numéros Twilio et sélectionnez ceux à importer. 5. Assignez les numéros importés à un agent quand vous voulez les utiliser. > **Erreur fréquente :** Utiliser des identifiants Twilio incorrects (par exemple le mauvais projet). Si aucun numéro n’apparaît, vérifiez l’identifiant, le jeton et la bonne sous-compte. *** ### Option C : Ajouter un numéro personnel (appels sortants uniquement) Un **numéro personnel** est utile pour passer des appels sortants avec votre propre numéro, mais il a une limitation clé : * **Uniquement pour les appels sortants** * **Ne peut pas recevoir d’appels entrants** dans Callin.ioCapture : Ajout d’un numéro personnel avec le flux de vérification (vous recevez un appel et complétez le code).
#### Comment vérifier votre numéro personnel 1. Allez sur [Ouvrir Numéros](https://app.callin.io/numbers). 2. Cliquez sur l’action d’ajout, puis choisissez l’option numéro personnel. 3. Choisissez le pays et saisissez votre numéro. 4. Lancez la vérification. 5. Vous recevrez un **appel de vérification**. 6. Saisissez le code lorsque cela vous est demandé. 7. Une fois vérifié, le numéro est ajouté à votre compte. > **Important :** Pour recevoir des appels entrants, utilisez un numéro acheté/importé ou BYOC (SIP Trunk). *** ### Option D : Ajouter/importer des numéros Telnyx Si vous avez déjà connecté Telnyx (via BYOC), vous pourrez importer vos numéros actifs : 1. Allez sur [Ouvrir Numéros](https://app.callin.io/numbers). 2. Cliquez sur l’action d’ajout, puis choisissez l’option Telnyx. 3. Sélectionnez les numéros à ajouter/importer. 4. Confirmez et assignez-les à vos agents si nécessaire. *** ### Assigner un numéro à un agent Acheter ou importer un numéro n’est pas toujours la dernière étape. Dans la liste Numéros, faites attention aux avertissements du type : * le numéro n’est assigné à aucun agent Si cela apparaît, assignez le numéro à l’agent concerné avant de passer des appels réels. > **Conseil :** Gardez un numéro “test” séparé du numéro de production pendant que vous ajustez les instructions et les flux d’appel. *** ## BYOC (SIP Trunk) BYOC (Bring Your Own Carrier) vous permet d’utiliser votre propre fournisseur de téléphonie en le connectant via un **SIP Trunk**, au lieu de dépendre de numéros gérés par Callin.io. Accédez directement à la configuration ici : [Ouvrir BYOC](https://app.callin.io/byoc)Capture : Écran BYOC pour connecter Telnyx, synchroniser les DIDs et provisionner le SIP Trunk.
### Qu’est-ce qu’un SIP Trunk (simplement) Un **SIP Trunk** est une connexion “téléphonie via internet” entre votre opérateur et votre système d’appels. Il est souvent utilisé en entreprise pour gérer les appels entrants/sortants avec contrôle du routage, du SBC, des identifiants et des politiques. *** ### Option 1 : Connecter Telnyx Si vous utilisez Telnyx, Callin.io guide le processus via une clé API : 1. Allez sur [Ouvrir BYOC](https://app.callin.io/byoc). 2. Ouvrez l’onglet Telnyx. 3. Collez votre clé API Telnyx. 4. Démarrez la configuration. Pendant le processus, vous verrez généralement des étapes comme : * Enregistrer la clé API Telnyx * Récupérer les numéros actifs (DIDs) * Enregistrer les numéros dans votre compte * Provisionner le SIP Trunk (appels entrants et sortants) À la fin, vos numéros Telnyx devraient apparaître dans Numéros. > **Important :** Si votre clé API n’a pas les permissions nécessaires pour lire les DIDs/numéros, Callin.io ne pourra pas les importer. *** ### Option 2 : Connecter un autre fournisseur (trunk SIP générique) Si votre fournisseur n’est pas Telnyx, utilisez l’onglet autre fournisseur SIP. Vous verrez généralement trois sections : **Base**, **Entrant** et **Sortant**. #### Base * **Libellé** : un nom descriptif (exemple : “HQ SIP Trunk”) * **Numéro au format E.164** : format international complet (exemple : `+15551234567`) * Options comme prise en charge des appels entrants et sortants #### Entrant * **SBC/FQDN entrant** : adresse SIP de destination (exemple : `sip.example.com:5061`) * **Transport** : généralement TLS ou UDP * **Chiffrement média** : activez-le si votre fournisseur le prend en charge > **Conseil :** Côté entrant, il n’y a souvent pas d’identifiants. Beaucoup d’opérateurs authentifient via la configuration du trunk ou une liste d’adresses autorisées. #### Sortant * **SBC/FQDN sortant** : serveur SIP du fournisseur * **Transport** et **chiffrement média** * **Nom d’utilisateur** et **mot de passe** : identifiants SIP * **Pays autorisés (sortant)** : par exemple partout dans le monde ou liste personnalisée Une fois terminé, enregistrez et importez. > **Erreur fréquente :** Un SBC/FQDN incorrect ou des identifiants erronés. Si les appels sortants échouent, vérifiez l’utilisateur/mot de passe, le transport et les ports requis par votre fournisseur. *** ## Minutes et facturation (l’essentiel) La facturation comporte généralement deux parties : * **Utilisation Callin (compute minutes)** : temps pendant lequel l’agent est actif (écoute, traite et répond). * **Coûts de téléphonie** : dépendent de la façon dont vous connectez le numéro et du fournisseur utilisé. ### Avis important de facturation (première minute) Lorsque vous passez des appels en utilisant une téléphonie routée via le fournisseur de Callin (par exemple des numéros achetés via Callin.io), une règle de **facturation de la première minute** peut s’appliquer : * Le minimum facturé est **1 minute** * Si l’appel dure plus d’une minute, après la première minute la facturation suit la durée réelle (sans frais supplémentaires au-delà du minimum) De plus, lorsque vous achetez un numéro Telnyx/Twilio via Callin.io : * **Aucun frais de plateforme supplémentaire n’est ajouté pour le numéro lui-même** Cette règle de première minute ne s’applique généralement pas à : * Les appels de test depuis le navigateur * Les numéros importés (Twilio ou Telnyx) * Un trunk SIP externe (BYOC) > **Important :** Le comportement exact peut varier selon la configuration du routage de votre compte. Si vous voulez éviter les règles liées à un fournisseur géré par Callin, utilisez des numéros importés ou BYOC (SIP Trunk). ### Rappel : facturation avec un numéro personnel Un **numéro personnel** est **uniquement pour les appels sortants**, et peut entrer dans le périmètre de facturation du fournisseur de Callin selon la façon dont vos appels sont routés. > **Important :** Même si vous utilisez un numéro personnel pour les appels sortants, pour les appels entrants vous aurez besoin d’un numéro acheté/importé ou BYOC (SIP Trunk). *** ## Dépannage ### “Je n’arrive pas à passer des appels” * Vérifiez que vous avez au moins **un numéro actif** * Vérifiez que le numéro est **assigné à un agent** * Si vous utilisez BYOC (SIP Trunk), validez le **SBC/FQDN**, le transport, le chiffrement média et les identifiants ### “Mon numéro personnel ne reçoit pas d’appels entrants” * C’est normal : un **numéro personnel est uniquement pour les appels sortants** * Utilisez un numéro acheté/importé ou BYOC (SIP Trunk) pour recevoir des appels ### “Mes numéros importés n’apparaissent pas” * Vérifiez les identifiants (Twilio Account SID/Auth Token ou clé API Telnyx) * Confirmez que les numéros sont actifs chez le fournisseur * Vérifiez que vous utilisez le bon compte/sous-compte *** ## Note finale Si vous cherchez la configuration la plus rapide, commencez par un numéro **États-Unis ou Canada** acheté via Callin.io. Si vous avez déjà un opérateur ou si vous avez besoin de plus de contrôle sur le routage, connectez BYOC (SIP Trunk). Une fois le numéro ajouté et assigné, vos agents IA pourront passer et recevoir des appels réels à grande échelle. # Numeri e BYOC Source: https://support.callin.io/Create-AI-Agent/Configure-Numbers-copied-5 Impara ad acquistare, importare o verificare numeri di telefono e a collegare BYOC (SIP Trunk) affinché i tuoi agenti IA possano effettuare e ricevere chiamate. ## Panoramica I numeri di telefono sono il collegamento tra i tuoi agenti IA e le chiamate reali. In Callin.io lo gestisci in due aree: * **Numeri**: Acquista numeri tramite Callin.io, importali dai provider oppure verifica un numero personale. * **BYOC (SIP Trunk)**: Porta il tuo carrier collegando Telnyx o qualsiasi provider SIP. Usa questi collegamenti rapidi per aprire ogni sezione nell’app: * Vai a **Numeri**: [Apri Numeri](https://app.callin.io/numbers) * Vai a **BYOC (SIP Trunk)**: [Apri BYOC](https://app.callin.io/byoc) > **Suggerimento:** Se vuoi partire subito, acquista un numero **Stati Uniti o Canada** (di solito è istantaneo). Per un numero internazionale, preparati a fornire dati e caricare documenti (le regole variano in base al Paese). *** ## Numeri La pagina **Numeri** mostra tutti i numeri collegati al tuo workspace (acquistati, importati, personale, Telnyx o BYOC). Da qui puoi aggiungere nuovi numeri, controllare lo stato e vedere avvisi importanti (ad esempio se un numero non è ancora assegnato a un agente).Screenshot: La pagina Numeri, con filtri per provider e il menu per acquistare o importare numeri.
### Cosa puoi fare da Numeri Cliccando sull’azione di aggiunta (ad esempio **+ Aggiungi numero**) vedrai di solito opzioni come (le diciture possono variare in base al tuo account, al piano o alla lingua dell’interfaccia): * Acquistare un numero tramite Callin.io * Importare da Twilio * Aggiungere un numero personale * Aggiungere un numero Telnyx (dopo aver collegato Telnyx) Spesso sono disponibili anche filtri per tipo/provenienza (acquistati, Twilio, personale, Telnyx, BYOC). *** ### Opzione A: Acquistare un numero tramite Callin.io Acquistare numeri tramite Callin.io è il modo più diretto per iniziare. #### Stati Uniti e Canada: acquisto istantaneo Per **Stati Uniti** e **Canada**, il flusso di acquisto è spesso rapido e immediato: 1. Vai su [Apri Numeri](https://app.callin.io/numbers). 2. Clicca sull’azione di aggiunta e scegli l’opzione di acquisto. 3. Seleziona il **Paese**. 4. Scegli il tipo: * **Locale** * **Numero verde** (se disponibile) 5. (Opzionale) Cerca per **prefisso** (esempio: `415`). 6. Avvia la ricerca. 7. Seleziona un numero dall’elenco. 8. Conferma l’acquisto del numero selezionato. > **Importante:** Se vedi un avviso che indica che il numero non è assegnato a nessun agente, il numero non è ancora pronto: prima devi assegnarlo a un agente. #### Altri paesi: richiesta + documentazioneSchermata: dopo aver avviato la richiesta, la piattaforma carica i campi e i documenti specifici del paese che devi completare prima del pagamento e della revisione.
Per molti paesi **al di fuori di Stati Uniti/Canada**, l’acquisto segue un flusso **basato su richiesta** invece di un acquisto immediato. * Selezioni il paese e il tipo di numero, ad esempio **Locale** o **Mobile**. * Potresti vedere opzioni di **Tipo di richiesta** come **Nuovo numero** e **Portabilità**. * Scegli uno dei numeri disponibili e fai clic su **Avvia richiesta**. * La piattaforma carica quindi le informazioni e i requisiti documentali **specifici del paese**. * Devi compilare i campi richiesti, caricare i documenti e salvare ogni elemento. * Invi la richiesta, paghi le eventuali tariffe richieste e poi la richiesta viene esaminata da un operatore. Di solito puoi monitorare queste richieste in una scheda come **Richieste di numeri**. Questa parte del processo è importante perché i requisiti non sono sempre gli stessi. Possono cambiare in base al **paese**, al **tipo di numero** e al fatto che la richiesta venga effettuata da una **persona fisica**, da una **ditta individuale** o da un’**azienda**. ##### Come funziona la fase di documentazione Dopo aver fatto clic su **Avvia richiesta**, il modulo può mostrare una combinazione di: * Campi di testo da compilare manualmente * Campi di caricamento per i documenti di supporto * Un pulsante **Salva** per ogni singolo requisito * Uno stato **In sospeso** finché quello specifico elemento non viene salvato o caricato correttamente Questo significa che la richiesta viene normalmente completata **pezzo per pezzo**, non tutta in una volta. Se un campo o un caricamento mostra ancora **In sospeso**, quel requisito di solito non è ancora completo. In molti paesi con richiesta preventiva, il modulo può richiedere dettagli come: * **Tipo di documento di identità** * **Numero del documento di identità** * **Data di nascita** * **Luogo di nascita** * **Ente emittente del documento di identità** * **Data di scadenza del documento di identità** * **Indirizzo locale nello stesso paese** * **Codice fiscale personale** * **Partita IVA** * **Codice fiscale dell’azienda** * **Tipo di cliente IT** * **Prova di indirizzo** * **Copia del passaporto/documento di identità** * **Certificato di registrazione dell’azienda** Alcune etichette possono anche chiarire chi deve fornire ciascun elemento, ad esempio: * **Solo per persone giuridiche** * **Solo per persone giuridiche e ditte individuali** * **Solo per persone fisiche e ditte individuali** Quindi, anche se due clienti richiedono numeri nello stesso paese, la documentazione richiesta può variare in base al tipo di attività e alla categoria esatta del numero. > **Suggerimento:** Nel modulo di richiesta, alcuni campi hanno un proprio pulsante **Salva**. Inserire un valore non è sempre sufficiente da solo. L’elemento può continuare a mostrare **In sospeso** finché non fai clic correttamente su **Salva**. ##### Requisiti documentali comuni (esempi) I requisiti esatti dipendono dal paese e dal tipo di numero, ma potrebbero essere richiesti elementi come questi: | Requisito | Cosa significa | Esempio | | ----------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- | | Indirizzo corrispondente al prefisso DID | Potresti aver bisogno di un indirizzo nella stessa città, regione o area di copertura del numero che stai richiedendo | “Via Roma 22, Milano” per un numero locale di Milano | | Documento nazionale di identità / Codice fiscale | Identificazione personale o aziendale utilizzata per convalidare il richiedente | Numero di passaporto, documento nazionale di identità, codice fiscale, partita IVA | | Informazioni di contatto | Una persona o un contatto aziendale raggiungibile per la richiesta | “Luca Bianchi, +39 345 000 1111” | | Prova di indirizzo (caricamento) | Un documento che mostri l’indirizzo inserito nella richiesta | Bolletta, estratto conto bancario, contratto di affitto o lettera ufficiale del governo | | Copia del passaporto/documento di identità (caricamento) | Verifica dell’identità per una persona fisica o un rappresentante aziendale | Scansione del passaporto o copia fronte/retro del documento | | Certificato aziendale (caricamento) | Prova che l’azienda è legalmente registrata | Certificato di costituzione, estratto del registro delle imprese | | Codice fiscale dell’azienda / Partita IVA | Informazioni fiscali aziendali per richieste intestate a un’impresa | Partita IVA o codice fiscale dell’azienda | | Data e luogo di nascita | Dati identificativi personali richiesti in alcuni paesi | “14 marzo 1988, Napoli” | | Ente emittente e data di scadenza del documento di identità | Informazioni sull’autorità emittente e sulla validità del documento | “Rilasciato dal Comune di Torino, scadenza 08/2028” | ##### Prova di indirizzo: cosa causa più spesso problemi Il documento di **prova di indirizzo** è uno dei motivi più comuni per cui una richiesta viene ritardata. In molti paesi, il documento di prova di indirizzo caricato deve soddisfare tutte queste condizioni: * Deve mostrare chiaramente lo **stesso nome** utilizzato nella richiesta, oppure il nome dell’azienda se la richiesta è aziendale * Deve mostrare chiaramente lo **stesso indirizzo** inserito nel modulo * Deve essere **recente** * Deve essere completo e leggibile * Non deve essere ritagliato in modo da nascondere dettagli importanti Una regola molto importante è che la bolletta o il documento di indirizzo deve spesso avere una data **non superiore a 3 mesi** al momento dell’invio. Questo significa di solito che dovresti caricare un documento recente come: * Una bolletta emessa negli ultimi 3 mesi * Un estratto conto bancario emesso negli ultimi 3 mesi * Una lettera ufficiale governativa o fiscale emessa negli ultimi 3 mesi I documenti più vecchi possono essere rifiutati anche se l’indirizzo è corretto. > **Importante:** Quando carichi una bolletta o un estratto conto bancario come prova di indirizzo, assicurati che abbia **meno di 3 mesi**. Se il documento è più vecchio, la richiesta potrebbe rimanere in sospeso o essere rifiutata durante la revisione. ##### Come preparare i documenti prima del caricamento Per evitare ritardi, controlla ogni documento prima di caricarlo. Un buon documento dovrebbe essere: * **Chiaro e leggibile** * **Completo**, senza bordi tagliati * **Coerente** con i dati inseriti nel modulo * **Aggiornato**, soprattutto nel caso delle prove di indirizzo * **Adatto** al tipo di richiedente, sia esso persona fisica o azienda Ad esempio, se la richiesta è per un’azienda, il revisore potrebbe aspettarsi che il nome dell’azienda, il numero di registrazione, i dati fiscali e i documenti societari coincidano tra loro. Se la richiesta è per una persona fisica, il revisore potrebbe verificare che il nome personale, il documento di identità e la prova di indirizzo corrispondano. Problemi comuni che possono rallentare l’approvazione includono: * L’indirizzo nel modulo non corrisponde a quello del documento caricato * La bolletta caricata ha più di 3 mesi * La copia del passaporto o del documento di identità è sfocata * Una richiesta aziendale viene inviata solo con documenti personali * Un campo è stato compilato, ma l’utente non ha fatto clic su **Salva** * Un documento è stato caricato, ma il suo stato mostra ancora **In sospeso** > **Errore comune:** Caricare il file corretto non è sempre sufficiente. Dopo ogni caricamento o inserimento di testo, verifica che il requisito non mostri più **In sospeso**. ##### Tariffe + revisione Alcuni paesi mostrano una fase di **pagamento delle tariffe** dopo il completamento della documentazione. Questo può includere: * Una **tariffa di attivazione una tantum** * Il **costo mensile ricorrente** del numero La richiesta di solito procede solo dopo che i documenti richiesti sono stati caricati e la fase di pagamento è stata completata. Dopo l’invio e il pagamento: * Riceverai un **ID richiesta** * La richiesta verrà esaminata da un operatore * Una volta approvato, il numero apparirà nel tuo elenco Numbers La revisione è manuale in molti casi, quindi l’approvazione non è sempre immediata. > **Importante:** I tempi di approvazione possono variare in base al paese, alle regole del provider e alla qualità della documentazione. Se hai bisogno del numero per un lancio o una campagna imminente, invia la richiesta il prima possibile e utilizza documenti recenti e chiaramente leggibili. *** ### Opzione B: Importare numeri da Twilio Se hai già numeri su Twilio, puoi importarli in Callin.io: 1. Vai su [Apri Numeri](https://app.callin.io/numbers). 2. Clicca sull’azione di aggiunta e scegli l’import da Twilio. 3. Inserisci l’identificativo account Twilio e il token di autenticazione Twilio. 4. Avvia la ricerca dei numeri Twilio e seleziona quelli da importare. 5. Assegna i numeri importati a un agente quando vuoi usarli. > **Errore comune:** Usare credenziali Twilio sbagliate (ad esempio il progetto errato). Se non appare alcun numero, verifica identificativo, token e l’account o sotto-account corretto. *** ### Opzione C: Aggiungere un numero personale (solo chiamate in uscita) Un **numero personale** è utile per effettuare chiamate in uscita con il tuo numero, ma ha un limite fondamentale: * **Solo per chiamate in uscita** * **Non può ricevere chiamate in entrata** in Callin.ioScreenshot: Aggiunta numero personale con flusso di verifica (ricevi una chiamata e completi il codice).
#### Come verificare il tuo numero personale 1. Vai su [Apri Numeri](https://app.callin.io/numbers). 2. Clicca sull’azione di aggiunta e scegli l’opzione numero personale. 3. Seleziona il Paese e inserisci il numero. 4. Avvia la verifica. 5. Riceverai una **chiamata di verifica**. 6. Inserisci il codice quando richiesto. 7. Dopo la verifica, il numero viene aggiunto al tuo account. > **Importante:** Per ricevere chiamate in entrata, usa un numero acquistato/importato oppure BYOC (SIP Trunk). *** ### Opzione D: Aggiungere/importare numeri Telnyx Se hai già collegato Telnyx (tramite BYOC), potrai importare i tuoi numeri attivi: 1. Vai su [Apri Numeri](https://app.callin.io/numbers). 2. Clicca sull’azione di aggiunta e scegli l’opzione Telnyx. 3. Seleziona i numeri da aggiungere/importare. 4. Conferma e assegnali agli agenti quando necessario. *** ### Assegnare un numero a un agente Acquistare o importare un numero non è sempre l’ultimo passaggio. Nell’elenco Numeri, presta attenzione ad avvisi come: * il numero non è assegnato a nessun agente Se compare, assegna il numero all’agente corretto prima di effettuare chiamate reali. > **Suggerimento:** Tieni un numero “di test” separato dal numero di produzione mentre perfezioni istruzioni e flussi di chiamata. *** ## BYOC (SIP Trunk) BYOC (Bring Your Own Carrier) ti permette di usare il tuo provider di telefonia collegandolo tramite un **SIP Trunk**, invece di dipendere da numeri gestiti da Callin.io. Apri direttamente la configurazione qui: [Apri BYOC](https://app.callin.io/byoc)Screenshot: Schermata BYOC per collegare Telnyx, sincronizzare i DIDs e predisporre il SIP Trunk.
### Che cos’è un SIP Trunk (in parole semplici) Un **SIP Trunk** è una connessione “telefonia via internet” tra il tuo carrier e il tuo sistema di chiamate. È molto usato in ambito aziendale per gestire chiamate in entrata e in uscita con controllo di instradamento, SBC, credenziali e policy. *** ### Opzione 1: Collegare Telnyx Se usi Telnyx, Callin.io guida il processo tramite una chiave API: 1. Vai su [Apri BYOC](https://app.callin.io/byoc). 2. Apri la scheda Telnyx. 3. Incolla la chiave API Telnyx. 4. Avvia la configurazione. Durante il processo vedrai di solito passaggi come: * Salvare la chiave API Telnyx * Recuperare numeri attivi (DIDs) * Salvare i numeri nel tuo account * Predisporre il SIP Trunk (chiamate in entrata e in uscita) Alla fine, i numeri Telnyx dovrebbero comparire in Numeri. > **Importante:** Se la chiave API non ha le autorizzazioni per leggere DIDs/numeri, Callin.io non potrà importarli. *** ### Opzione 2: Collegare un altro provider (trunk SIP generico) Se il tuo provider non è Telnyx, usa la scheda per altro provider SIP. In genere vedrai tre sezioni: **Base**, **Entrata** e **Uscita**. #### Base * **Etichetta**: un nome descrittivo (esempio: “HQ SIP Trunk”) * **Numero in formato E.164**: formato internazionale completo (esempio: `+15551234567`) * Opzioni per abilitare chiamate in entrata e in uscita #### Entrata * **SBC/FQDN in entrata**: indirizzo SIP di destinazione (esempio: `sip.example.com:5061`) * **Trasporto**: di solito TLS o UDP * **Crittografia media**: abilitala se supportata dal provider > **Suggerimento:** Per le chiamate in entrata spesso non servono credenziali. Molti carrier autenticano tramite configurazione del trunk o lista IP consentite. #### Uscita * **SBC/FQDN in uscita**: server SIP del provider * **Trasporto** e **crittografia media** * **Nome utente** e **password**: credenziali SIP * **Paesi consentiti (uscita)**: ad esempio tutto il mondo o lista personalizzata Una volta completato, salva e importa. > **Errore comune:** SBC/FQDN errato o credenziali non corrette. Se le chiamate in uscita non funzionano, verifica utente/password, trasporto e porte richieste dal provider. *** ## Minuti e fatturazione (le informazioni essenziali) La fatturazione di solito ha due componenti: * **Utilizzo Callin (compute minutes)**: tempo in cui l’agente è attivo (ascolta, elabora e risponde). * **Costi di telefonia**: dipendono da come colleghi il numero e dal provider utilizzato. ### Avviso importante sulla fatturazione (primo minuto) Quando effettui chiamate usando telefonia instradata tramite il provider di Callin (ad esempio numeri acquistati tramite Callin.io), può applicarsi una regola di **fatturazione del primo minuto**: * Il minimo addebitato è **1 minuto** * Se la chiamata dura più di un minuto, dopo il primo minuto la fatturazione segue la durata reale (senza costi aggiuntivi oltre il minimo) Inoltre, quando acquisti un numero Telnyx/Twilio tramite Callin.io: * **Non viene aggiunta alcuna tariffa di piattaforma extra per il numero in sé** Questa regola del primo minuto di solito non si applica a: * Chiamate di test dal browser * Numeri importati (Twilio o Telnyx) * Trunk SIP esterno (BYOC) > **Importante:** Il comportamento esatto può variare in base alla configurazione di instradamento del tuo account. Se vuoi evitare regole legate a un provider gestito da Callin, usa numeri importati o BYOC (SIP Trunk). ### Promemoria: fatturazione con numero personale Un **numero personale** è **solo per chiamate in uscita** e può rientrare nella fatturazione del provider di Callin a seconda di come vengono instradate le chiamate. > **Importante:** Anche se usi un numero personale per le chiamate in uscita, per le chiamate in entrata ti serve un numero acquistato/importato o BYOC (SIP Trunk). *** ## Risoluzione dei problemi ### “Non riesco a effettuare chiamate” * Verifica di avere almeno **un numero attivo** * Controlla che il numero sia **assegnato a un agente** * Se usi BYOC (SIP Trunk), verifica **SBC/FQDN**, trasporto, crittografia media e credenziali ### “Il mio numero personale non riceve chiamate in entrata” * È normale: un **numero personale è solo per chiamate in uscita** * Usa un numero acquistato/importato o BYOC (SIP Trunk) per ricevere chiamate ### “I miei numeri importati non compaiono” * Verifica le credenziali (Twilio Account SID/Auth Token oppure chiave API Telnyx) * Conferma che i numeri siano attivi presso il provider * Controlla di usare l’account o sotto-account corretto *** ## Nota finale Se vuoi la configurazione più rapida, inizia con un numero **Stati Uniti o Canada** acquistato tramite Callin.io. Se hai già un carrier o ti serve più controllo sull’instradamento, collega BYOC (SIP Trunk). Una volta aggiunto e assegnato, i tuoi agenti IA potranno effettuare e ricevere chiamate reali su larga scala. # Connect Make Source: https://support.callin.io/Create-AI-Agent/Connect-Make Integrate Callin.io with Make and build visual automations using your API Key. ## Before You Begin Make (formerly Integromat) is a visual automation platform that lets you connect Callin.io with thousands of applications and design workflows without writing code.\ You can build automation “scenarios” by linking modules that perform specific actions — each representing a step in your process. With this integration, you can: * Automatically receive call transcriptions. * Trigger outbound calls from your CRM or web forms. * Save call data in spreadsheets or databases. * Notify your team when a new call is received. ## Step 1. Access the Integrations Panel in Callin.io Log in to your [Callin.io account](https://app.callin.io).\ From the left sidebar, open [Actions](https://app.callin.io/actions). Under **All Integrations**, find **Make.com** and click **Connect**.\ A new window will open to take you to your Make account. ## Step 2. Create or Log In to Your Make Account Go to [Make.com](https://www.make.com) and log in, or create a free account.\ Once inside, click **Create a new scenario** to start building your automation. ## Step 3. Get Your API Key from Callin.io Make needs your API Key to authenticate your Callin.io account. In Callin.io, open your [profile](https://app.callin.io/profile?subSection=api).\ Select **API Keys** to view your key. Copy your API Key.\ If you don’t have one, click **Regenerate Key** to create a new one.\ Keep this key secure. If it’s compromised, regenerate it immediately. ## Step 4. Connect Callin.io to Make In your Make scenario, click the **+** icon and search for “Callin.io”.\ Select the desired module, such as **Get Transcription** or **Make Call**. When prompted, click **Add** to connect a new account.\ Paste your API Key in the authentication window.\ Click **Save**. Your Callin.io account will now appear as connected. ## Step 5. Build Your First Scenario Let’s create a simple example: saving every call transcription in Google Sheets. 1. Choose **Callin.io – Get Transcription** as the trigger module. 2. Add a second module: **Google Sheets – Add a Row**. 3. Link both modules together. 4. Select the sheet and map Callin.io fields (such as Caller, Date, Transcription) to your spreadsheet columns. 5. Save and run the scenario. From now on, every completed call will automatically send its transcription to your sheet. ## Advanced Configuration With Make, you can combine multiple actions and conditions to create powerful automations: * Automatically initiate calls when new leads are created. * Send Slack notifications when specific criteria are met. * Store transcriptions and recordings in Google Drive or another cloud service. All your Callin.io modules are available within the Make interface for maximum flexibility.\ You can also manage integrations directly from [Actions → Make](https://app.callin.io/actions) in your Callin.io dashboard. ## Common Issues and Solutions **Connection fails when entering the API Key.**\ Make sure there are no extra spaces when pasting. If the issue persists, regenerate the key from the [API Keys section](https://app.callin.io/profile?subSection=api). **Scenario doesn’t receive data.**\ Check that the selected event in Callin.io (e.g., Get Transcription) is active. **Scenario doesn’t run automatically.**\ Ensure it’s saved and activated. You can test it manually using **Run once**. ## Final Note Integrating Callin.io with Make allows you to design custom workflows visually and automate communication tasks effortlessly.\ Once your first scenario is up and running, you’ll find it easy to expand and connect Callin.io to any other system you use daily. # Make verbinden Source: https://support.callin.io/Create-AI-Agent/Connect-Make-copied-1 Integriere Callin.io mit Make und baue visuelle Automatisierungen mit deinem API Key. ## Bevor du beginnst Make (früher Integromat) ist eine visuelle Automatisierungsplattform, mit der du Callin.io mit Tausenden von Anwendungen verbinden und Workflows ohne Programmierung erstellen kannst.\ Du kannst Automatisierungs-„Szenarien“ erstellen, indem du Module verknüpfst, die bestimmte Aktionen ausführen — jedes Modul stellt einen Schritt in deinem Prozess dar. Mit dieser Integration kannst du: * Automatisch Anruf-Transkriptionen erhalten. * Ausgehende Anrufe aus deinem CRM oder aus Webformularen auslösen. * Anrufdaten in Tabellen oder Datenbanken speichern. * Dein Team benachrichtigen, wenn ein neuer Anruf eingeht. ## Schritt 1. Das Integrations-Panel in Callin.io öffnen Melde dich in deinem [Callin.io account](https://app.callin.io) an.\ Öffne in der linken Seitenleiste [Actions](https://app.callin.io/actions). Suche unter **All Integrations** nach **Make.com** und klicke auf **Connect**.\ Es öffnet sich ein neues Fenster, das dich zu deinem Make-Konto weiterleitet. ## Schritt 2. Ein Make-Konto erstellen oder einloggen Gehe zu [Make.com](https://www.make.com) und melde dich an oder erstelle ein kostenloses Konto.\ Klicke anschließend auf **Create a new scenario**, um mit deiner Automatisierung zu beginnen. ## Schritt 3. Deinen API Key in Callin.io abrufen Make benötigt deinen API Key, um dein Callin.io-Konto zu authentifizieren. Öffne in Callin.io dein [profile](https://app.callin.io/profile?subSection=api).\ Wähle **API Keys**, um deinen Schlüssel anzuzeigen. Kopiere deinen API Key.\ Wenn du keinen hast, klicke auf **Regenerate Key**, um einen neuen zu erstellen.\ Bewahre diesen Key sicher auf. Wenn er kompromittiert wird, regeneriere ihn sofort. ## Schritt 4. Callin.io mit Make verbinden Klicke in deinem Make-Szenario auf das **+**-Symbol und suche nach „Callin.io“.\ Wähle das gewünschte Modul, zum Beispiel **Get Transcription** oder **Make Call**. Wenn du dazu aufgefordert wirst, klicke auf **Add**, um ein neues Konto zu verbinden.\ Füge deinen API Key im Authentifizierungsfenster ein.\ Klicke auf **Save**. Dein Callin.io-Konto wird nun als verbunden angezeigt. ## Schritt 5. Dein erstes Szenario erstellen Erstellen wir ein einfaches Beispiel: Jede Anruf-Transkription automatisch in Google Sheets speichern. 1. Wähle **Callin.io – Get Transcription** als Trigger-Modul. 2. Füge ein zweites Modul hinzu: **Google Sheets – Add a Row**. 3. Verknüpfe beide Module miteinander. 4. Wähle das Sheet aus und mappe Callin.io-Felder (zum Beispiel Anrufer, Datum, Transkription) auf die Spalten deiner Tabelle. 5. Speichere und starte das Szenario. Ab jetzt sendet jeder abgeschlossene Anruf seine Transkription automatisch in dein Sheet. ## Erweiterte Konfiguration Mit Make kannst du mehrere Aktionen und Bedingungen kombinieren, um leistungsstarke Automatisierungen zu erstellen: * Anrufe automatisch starten, wenn neue Leads erstellt werden. * Slack-Benachrichtigungen senden, wenn bestimmte Kriterien erfüllt sind. * Transkriptionen und Recordings in Google Drive oder einem anderen Cloud-Service speichern. Alle Callin.io-Module stehen dir in der Make-Oberfläche für maximale Flexibilität zur Verfügung.\ Du kannst Integrationen auch direkt in deinem Callin.io-Dashboard unter [Actions → Make](https://app.callin.io/actions) verwalten. ## Häufige Probleme und Lösungen **Verbindung schlägt beim Eingeben des API Key fehl.**\ Stelle sicher, dass beim Einfügen keine zusätzlichen Leerzeichen enthalten sind. Wenn das Problem weiter besteht, regeneriere den Key im Bereich [API Keys section](https://app.callin.io/profile?subSection=api). **Szenario empfängt keine Daten.**\ Prüfe, ob das ausgewählte Event in Callin.io (z. B. Get Transcription) aktiv ist. **Szenario läuft nicht automatisch.**\ Stelle sicher, dass es gespeichert und aktiviert ist. Du kannst es manuell über **Run once** testen. ## Abschlusshinweis Die Integration von Callin.io mit Make ermöglicht es dir, individuelle Workflows visuell zu gestalten und Kommunikationsaufgaben mühelos zu automatisieren.\ Sobald dein erstes Szenario läuft, wirst du es leicht erweitern und Callin.io mit jedem anderen System verbinden können, das du täglich nutzt. # Conectar Make Source: https://support.callin.io/Create-AI-Agent/Connect-Make-copied-2 Integra Callin.io con Make y crea automatizaciones visuales usando tu API Key. ## Antes de empezar Make (antes Integromat) es una plataforma de automatización visual que te permite conectar Callin.io con miles de aplicaciones y diseñar flujos de trabajo sin escribir código.\ Puedes crear “scenarios” de automatización enlazando módulos que realizan acciones específicas — cada uno representa un paso dentro de tu proceso. Con esta integración, puedes: * Recibir transcripciones de llamadas automáticamente. * Disparar llamadas salientes desde tu CRM o formularios web. * Guardar datos de llamadas en hojas de cálculo o bases de datos. * Notificar a tu equipo cuando se recibe una nueva llamada. ## Paso 1. Accede al panel de integraciones en Callin.io Inicia sesión en tu [cuenta de Callin.io](https://app.callin.io).\ Desde la barra lateral izquierda, abre [Actions](https://app.callin.io/actions). En **All Integrations**, busca **Make.com** y haz clic en **Connect**.\ Se abrirá una nueva ventana para llevarte a tu cuenta de Make. ## Paso 2. Crea o inicia sesión en tu cuenta de Make Ve a [Make.com](https://www.make.com) e inicia sesión, o crea una cuenta gratis.\ Una vez dentro, haz clic en **Create a new scenario** para empezar a construir tu automatización. ## Paso 3. Obtén tu API Key en Callin.io Make necesita tu API Key para autenticar tu cuenta de Callin.io. En Callin.io, abre tu [perfil](https://app.callin.io/profile?subSection=api).\ Selecciona **API Keys** para ver tu clave. Copia tu API Key.\ Si no tienes una, haz clic en **Regenerate Key** para crear una nueva.\ Mantén esta clave segura. Si se ve comprometida, regénérala inmediatamente. ## Paso 4. Conecta Callin.io con Make En tu escenario de Make, haz clic en el icono **+** y busca “Callin.io”.\ Selecciona el módulo que quieras, como **Get Transcription** o **Make Call**. Cuando se te solicite, haz clic en **Add** para conectar una cuenta nueva.\ Pega tu API Key en la ventana de autenticación.\ Haz clic en **Save**. Tu cuenta de Callin.io aparecerá ahora como conectada. ## Paso 5. Crea tu primer escenario Vamos a crear un ejemplo simple: guardar cada transcripción de llamada en Google Sheets. 1. Elige **Callin.io – Get Transcription** como módulo trigger. 2. Añade un segundo módulo: **Google Sheets – Add a Row**. 3. Enlaza ambos módulos. 4. Selecciona la hoja y mapea los campos de Callin.io (como Caller, Date, Transcription) a las columnas de tu spreadsheet. 5. Guarda y ejecuta el escenario. A partir de ahora, cada llamada completada enviará automáticamente su transcripción a tu hoja. ## Configuración avanzada Con Make, puedes combinar múltiples acciones y condiciones para crear automatizaciones potentes: * Iniciar llamadas automáticamente cuando se crean nuevos leads. * Enviar notificaciones a Slack cuando se cumplan criterios específicos. * Guardar transcripciones y grabaciones en Google Drive u otro servicio cloud. Todos tus módulos de Callin.io están disponibles dentro de Make para máxima flexibilidad.\ También puedes gestionar integraciones directamente desde [Actions → Make](https://app.callin.io/actions) en tu panel de Callin.io. ## Problemas comunes y soluciones **La conexión falla al introducir la API Key.**\ Asegúrate de que no haya espacios extra al pegarla. Si el problema continúa, regenera la clave desde la [sección de API Keys](https://app.callin.io/profile?subSection=api). **El escenario no recibe datos.**\ Comprueba que el evento seleccionado en Callin.io (por ejemplo, Get Transcription) esté activo. **El escenario no se ejecuta automáticamente.**\ Asegúrate de que esté guardado y activado. Puedes probarlo manualmente usando **Run once**. ## Nota final Integrar Callin.io con Make te permite diseñar flujos personalizados de forma visual y automatizar tareas de comunicación sin esfuerzo.\ Cuando tu primer escenario esté funcionando, te resultará fácil ampliar y conectar Callin.io con cualquier otro sistema que uses a diario. # Connettere Make Source: https://support.callin.io/Create-AI-Agent/Connect-Make-copied-3 Integra Callin.io con Make e crea automazioni visuali usando la tua API Key. ## Prima di iniziare Make (in precedenza Integromat) è una piattaforma di automazione visuale che ti permette di collegare Callin.io con migliaia di applicazioni e progettare flussi di lavoro senza scrivere codice.\ Puoi creare “scenari” di automazione collegando moduli che eseguono azioni specifiche — ognuno rappresenta un passaggio del tuo processo. Con questa integrazione puoi: * Ricevere automaticamente le trascrizioni delle chiamate. * Avviare chiamate in uscita dal tuo CRM o da moduli web. * Salvare i dati delle chiamate in fogli di calcolo o database. * Notificare il tuo team quando arriva una nuova chiamata. ## Passo 1. Accedi al pannello integrazioni in Callin.io Accedi al tuo [account Callin.io](https://app.callin.io).\ Dal menu laterale sinistro, apri [Actions](https://app.callin.io/actions). In **All Integrations**, trova **Make.com** e fai clic su **Connect**.\ Si aprirà una nuova finestra per portarti al tuo account Make. ## Passo 2. Crea o accedi al tuo account Make Vai su [Make.com](https://www.make.com) ed effettua l’accesso, oppure crea un account gratuito.\ Una volta dentro, fai clic su **Create a new scenario** per iniziare a costruire la tua automazione. ## Passo 3. Ottieni la tua API Key da Callin.io Make ha bisogno della tua **API Key** per autenticare il tuo account Callin.io. In Callin.io, apri il tuo [profilo](https://app.callin.io/profile?subSection=api).\ Seleziona **API Keys** per visualizzare la tua chiave. Copia la tua API Key.\ Se non ne hai una, fai clic su **Regenerate Key** per crearne una nuova.\ Mantieni questa chiave al sicuro: se viene compromessa, rigenerala immediatamente. ## Passo 4. Collega Callin.io a Make Nel tuo scenario Make, fai clic sull’icona **+** e cerca “Callin.io”.\ Seleziona il modulo desiderato, ad esempio **Get Transcription** o **Make Call**. Quando richiesto, fai clic su **Add** per collegare un nuovo account.\ Incolla la tua API Key nella finestra di autenticazione.\ Fai clic su **Save**. Il tuo account Callin.io risulterà ora connesso. ## Passo 5. Crea il tuo primo scenario Creiamo un esempio semplice: salvare ogni trascrizione di chiamata in Google Sheets. 1. Scegli **Callin.io – Get Transcription** come modulo di trigger. 2. Aggiungi un secondo modulo: **Google Sheets – Add a Row**. 3. Collega i due moduli tra loro. 4. Seleziona il foglio e mappa i campi di Callin.io (ad esempio Caller, Date, Transcription) nelle colonne del foglio. 5. Salva ed esegui lo scenario. Da questo momento, ogni chiamata completata invierà automaticamente la sua trascrizione al tuo foglio. ## Configurazione avanzata Con Make puoi combinare più azioni e condizioni per creare automazioni potenti: * Avviare automaticamente chiamate quando viene creato un nuovo lead. * Inviare notifiche su Slack quando si verificano criteri specifici. * Archiviare trascrizioni e registrazioni in Google Drive o in un altro servizio cloud. Tutti i moduli di Callin.io sono disponibili nell’interfaccia Make per la massima flessibilità.\ Puoi anche gestire le integrazioni direttamente da [Actions → Make](https://app.callin.io/actions) nella dashboard di Callin.io. ## Problemi comuni e soluzioni **La connessione fallisce quando inserisci la API Key.**\ Assicurati che non ci siano spazi extra quando incolli. Se il problema continua, rigenera la chiave nella sezione [API Keys](https://app.callin.io/profile?subSection=api) e riprova. **Lo scenario non riceve dati.**\ Verifica che l’evento selezionato in Callin.io (ad esempio Get Transcription) sia attivo. **Lo scenario non si avvia automaticamente.**\ Assicurati che sia salvato e attivato. Puoi testarlo manualmente usando **Run once**. ## Nota finale Integrare Callin.io con Make ti consente di progettare flussi di lavoro personalizzati in modo visuale e automatizzare le attività di comunicazione con facilità.\ Una volta che il tuo primo scenario è attivo, sarà semplice espandere l’automazione e collegare Callin.io a qualsiasi altro sistema che usi ogni giorno. # Connecter Make Source: https://support.callin.io/Create-AI-Agent/Connect-Make-copied-4 Intégrez Callin.io à Make et créez des automatisations visuelles à l’aide de votre clé API. ## Avant de commencer Make (anciennement Integromat) est une plateforme d’automatisation visuelle qui vous permet de connecter Callin.io à des milliers d’applications et de concevoir des workflows sans écrire de code.\ Vous pouvez créer des « scénarios » d’automatisation en reliant des modules qui effectuent des actions spécifiques — chaque module représentant une étape de votre processus. Avec cette intégration, vous pouvez : * Recevoir automatiquement les transcriptions d’appels. * Déclencher des appels sortants depuis votre CRM ou des formulaires web. * Enregistrer les données d’appel dans des tableurs ou des bases de données. * Notifier votre équipe lorsqu’un nouvel appel est reçu. ## Étape 1. Accéder au panneau des intégrations dans Callin.io Connectez-vous à votre [compte Callin.io](https://app.callin.io).\ Dans la barre latérale gauche, ouvrez [Actions](https://app.callin.io/actions). Sous **All Integrations**, trouvez **Make.com** et cliquez sur **Connect**.\ Une nouvelle fenêtre s’ouvrira pour vous rediriger vers votre compte Make. ## Étape 2. Créer un compte Make ou se connecter Allez sur [Make.com](https://www.make.com) et connectez-vous, ou créez un compte gratuit.\ Une fois à l’intérieur, cliquez sur **Create a new scenario** pour commencer à construire votre automatisation. ## Étape 3. Récupérer votre clé API dans Callin.io Make a besoin de votre **clé API** pour authentifier votre compte Callin.io. Dans Callin.io, ouvrez votre [profil](https://app.callin.io/profile?subSection=api).\ Sélectionnez **API Keys** pour afficher votre clé. Copiez votre clé API.\ Si vous n’en avez pas, cliquez sur **Regenerate Key** pour en créer une nouvelle.\ Conservez cette clé en sécurité. Si elle est compromise, régénérez-la immédiatement. ## Étape 4. Connecter Callin.io à Make Dans votre scénario Make, cliquez sur l’icône **+** et recherchez « Callin.io ».\ Sélectionnez le module souhaité, par exemple **Get Transcription** ou **Make Call**. Lorsque cela vous est demandé, cliquez sur **Add** pour connecter un nouveau compte.\ Collez votre clé API dans la fenêtre d’authentification.\ Cliquez sur **Save**. Votre compte Callin.io apparaîtra alors comme connecté. ## Étape 5. Créer votre premier scénario Créons un exemple simple : enregistrer chaque transcription d’appel dans Google Sheets. 1. Choisissez **Callin.io – Get Transcription** comme module déclencheur. 2. Ajoutez un second module : **Google Sheets – Add a Row**. 3. Reliez les deux modules. 4. Sélectionnez la feuille et mappez les champs Callin.io (par exemple : Appelant, Date, Transcription) vers les colonnes de votre tableur. 5. Enregistrez et exécutez le scénario. À partir de maintenant, chaque appel terminé enverra automatiquement sa transcription dans votre feuille. ## Configuration avancée Avec Make, vous pouvez combiner plusieurs actions et conditions pour créer des automatisations puissantes : * Lancer automatiquement des appels lorsque de nouveaux leads sont créés. * Envoyer des notifications Slack lorsque certains critères sont remplis. * Stocker les transcriptions et les enregistrements dans Google Drive ou un autre service cloud. Tous vos modules Callin.io sont disponibles dans l’interface Make pour une flexibilité maximale.\ Vous pouvez aussi gérer les intégrations directement depuis [Actions → Make](https://app.callin.io/actions) dans votre tableau de bord Callin.io. ## Problèmes courants et solutions **La connexion échoue lors de la saisie de la clé API.**\ Vérifiez qu’il n’y a pas d’espaces en trop lors du collage. Si le problème persiste, régénérez la clé depuis la [section API Keys](https://app.callin.io/profile?subSection=api). **Le scénario ne reçoit pas de données.**\ Vérifiez que l’événement sélectionné côté Callin.io (par exemple, Get Transcription) est actif. **Le scénario ne s’exécute pas automatiquement.**\ Assurez-vous qu’il est enregistré et activé. Vous pouvez le tester manuellement avec **Run once**. ## Note finale Intégrer Callin.io à Make vous permet de concevoir visuellement des workflows personnalisés et d’automatiser des tâches de communication sans effort.\ Une fois votre premier scénario opérationnel, vous verrez qu’il est simple de l’étendre et de connecter Callin.io à n’importe quel autre système que vous utilisez au quotidien. # Connect N8n Source: https://support.callin.io/Create-AI-Agent/Connect-N8N Create powerful automations between Callin.io and your favorite tools using n8n. ## Overview Create powerful automations between Callin.io and your favorite tools with n8n. ## Steps ### Step 1: What is n8n and Why Use It with Callin.io? n8n (pronounced “en-eight-en”) is a workflow automation tool that connects different apps so they work together seamlessly. With Callin.io, this integration lets you: Send call data (caller, agent, duration, recording, etc.) to external apps. Create automations like sending Slack alerts after a call or adding call data to Google Sheets. Trigger outbound calls based on external events, such as a new CRM lead. In short: n8n turns your calls into triggers or actions for any automation flow. ### Step 2: Access the Callin.io Integrations Panel Log in to your Callin.io account. From the left menu, click Actions. In the dashboard, select the Automation or All Integrations tab. Find the n8n card and click Connect. You’ll be redirected to a login page like this one: [Callin.io Integrations](https://app.callin.io/actions) ### Step 3: Sign In to Your n8n Account A new tab will open with the URL n8n.callin.io. Enter your n8n email and password. If you don’t have access yet, contact your Callin.io administrator. Once inside, you’ll see the visual workflow builder of n8n. ### Step 4: Build Your First Automation Click + New Workflow and add the following nodes: Trigger: Select “Callin.io → New Call” to start the flow when a new call arrives. Action: Add an action such as: “Slack → Send Message” to alert your team. “Google Sheets → Add Row” to log call data. “Webhook → POST” to send data to a custom app. Example: ```json theme={null} { "Trigger": "Callin.io (New Call)", "Action": "Google Sheets (Add Row)", "Fields": ["Number", "Agent", "Duration", "Date"] } ``` ### Step 5: Activate and Test Save the workflow. Turn it on using the Active toggle. Make a test call from Callin.io and check if your automation works. ## Tips & Notes * **Custom Variables**: Use `{{callerName}}`, `{{callDuration}}`, or `{{agentEmail}}` to personalize your flows. * **Conditional Logic**: Add IF or Switch nodes for more complex automations. * **Chained Flows**: Combine Callin.io with CRMs and messaging tools in one continuous process. ## Troubleshooting **Symptom:** “Not Connected” error\ **Likely Cause:** Check your n8n credentials and integration permissions. **Symptom:** Flow not running\ **Likely Cause:** Ensure the workflow is Active in n8n. **Symptom:** Missing data\ **Likely Cause:** Verify that all Callin.io fields are properly mapped. ## Final Note Connecting Callin.io with n8n unlocks a world of smart automation.\ Start small—like sending a Slack message after each call—and soon you’ll see how n8n turns Callin.io into an intelligent automation hub. # n8n verbinden Source: https://support.callin.io/Create-AI-Agent/Connect-N8N-copied-1 Erstelle leistungsstarke Automatisierungen zwischen Callin.io und deinen bevorzugten Tools mit n8n. ## Überblick Erstelle leistungsstarke Automatisierungen zwischen Callin.io und deinen bevorzugten Tools mit n8n. ## Schritte ### Schritt 1: Was ist n8n und warum sollte man es mit Callin.io nutzen? n8n (ausgesprochen „en-eight-en“) ist ein Workflow-Automation-Tool, das verschiedene Apps miteinander verbindet, damit sie nahtlos zusammenarbeiten. Mit Callin.io ermöglicht dir diese Integration: Anrufdaten (Anrufer, Agent, Dauer, Recording usw.) an externe Apps zu senden. Automatisierungen zu erstellen, z. B. Slack-Benachrichtigungen nach einem Anruf zu senden oder Anrufdaten in Google Sheets zu schreiben. Ausgehende Anrufe auf Basis externer Ereignisse auszulösen, z. B. wenn ein neuer CRM-Lead erstellt wird. Kurz gesagt: n8n macht deine Anrufe zu Triggern oder Actions für jeden Automatisierungs-Flow. ### Schritt 2: Das Integrations-Panel von Callin.io öffnen Melde dich bei deinem Callin.io-Konto an. Klicke im linken Menü auf Actions. Wähle im Dashboard den Tab Automation oder All Integrations. Suche die n8n-Karte und klicke auf Connect. Du wirst zu einer Login-Seite wie dieser weitergeleitet: [Callin.io Integrations](https://app.callin.io/actions) ### Schritt 3: In dein n8n-Konto einloggen Ein neuer Tab öffnet sich mit der URL n8n.callin.io. Gib deine n8n-E-Mail und dein Passwort ein. Wenn du noch keinen Zugriff hast, kontaktiere deine Callin.io-Administration. Sobald du drin bist, siehst du den visuellen Workflow-Builder von n8n. ### Schritt 4: Deine erste Automatisierung erstellen Klicke auf + New Workflow und füge die folgenden Nodes hinzu: Trigger: Wähle „Callin.io → New Call“, um den Flow zu starten, wenn ein neuer Anruf eingeht. Action: Füge eine Aktion hinzu, zum Beispiel: „Slack → Send Message“, um dein Team zu benachrichtigen. „Google Sheets → Add Row“, um Anrufdaten zu protokollieren. „Webhook → POST“, um Daten an eine eigene App zu senden. ### Schritt 5: Aktivieren und testen Speichere den Workflow. Schalte ihn über den Active-Toggle ein. Führe einen Testanruf über Callin.io durch und prüfe, ob deine Automatisierung funktioniert. ## Tipps & Hinweise * **Benutzerdefinierte Variablen**: Nutze callerName, callDuration oder agentEmail, um deine Flows zu personalisieren. * **Bedingte Logik**: Füge IF- oder Switch-Nodes hinzu, um komplexere Automatisierungen zu erstellen. * **Verkettete Flows**: Kombiniere Callin.io mit CRMs und Messaging-Tools in einem durchgehenden Prozess. ## Fehlerbehebung **Symptom:** „Not Connected“-Fehler\ **Wahrscheinliche Ursache:** Prüfe deine n8n-Zugangsdaten und die Integrationsberechtigungen. **Symptom:** Flow läuft nicht\ **Wahrscheinliche Ursache:** Stelle sicher, dass der Workflow in n8n auf Active steht. **Symptom:** Fehlende Daten\ **Wahrscheinliche Ursache:** Prüfe, ob alle Callin.io-Felder korrekt gemappt sind. ## Abschlusshinweis Die Verbindung von Callin.io mit n8n eröffnet dir eine ganze Welt smarter Automatisierung.\ Starte klein — zum Beispiel mit einer Slack-Nachricht nach jedem Anruf — und du wirst schnell sehen, wie n8n Callin.io in ein intelligentes Automatisierungs-Hub verwandelt. # Conectar n8n Source: https://support.callin.io/Create-AI-Agent/Connect-N8N-copied-2 Crea automatizaciones potentes entre Callin.io y tus herramientas favoritas usando n8n. ## Resumen Crea automatizaciones potentes entre Callin.io y tus herramientas favoritas con n8n. ## Pasos ### Paso 1: ¿Qué es n8n y por qué usarlo con Callin.io? n8n (se pronuncia “en-eight-en”) es una herramienta de automatización de flujos de trabajo que conecta distintas aplicaciones para que funcionen juntas de forma fluida. Con Callin.io, esta integración te permite: Enviar datos de llamadas (llamante, agente, duración, grabación, etc.) a aplicaciones externas. Crear automatizaciones como enviar alertas a Slack después de una llamada o añadir datos de llamadas a Google Sheets. Disparar llamadas salientes basadas en eventos externos, como un nuevo lead en tu CRM. En resumen: n8n convierte tus llamadas en disparadores o acciones para cualquier flujo de automatización. ### Paso 2: Accede al panel de integraciones de Callin.io Inicia sesión en tu cuenta de Callin.io. Desde el menú izquierdo, haz clic en **Actions**. En el panel, selecciona la pestaña **Automation** o **All Integrations**. Encuentra la tarjeta de n8n y haz clic en **Connect**. Serás redirigido a una página de inicio de sesión como esta: [Integraciones de Callin.io](https://app.callin.io/actions) ### Paso 3: Inicia sesión en tu cuenta de n8n Se abrirá una nueva pestaña con la URL n8n.callin.io. Introduce tu email y contraseña de n8n. Si aún no tienes acceso, contacta con el administrador de Callin.io. Una vez dentro, verás el constructor visual de workflows de n8n. ### Paso 4: Crea tu primera automatización Haz clic en **+ New Workflow** y añade los siguientes nodos: Trigger: selecciona “Callin.io → New Call” para iniciar el flujo cuando llegue una nueva llamada. Action: añade una acción como: “Slack → Send Message” para alertar a tu equipo. “Google Sheets → Add Row” para registrar los datos de la llamada. “Webhook → POST” para enviar datos a una app personalizada. Ejemplo: ```json theme={null} { "Trigger": "Callin.io (New Call)", "Action": "Google Sheets (Add Row)", "Fields": ["Number", "Agent", "Duration", "Date"] } ``` ### Paso 5: Activa y prueba Guarda el workflow. Actívalo usando el interruptor **Active**. Haz una llamada de prueba desde Callin.io y comprueba si tu automatización funciona. ## Consejos y notas * **Variables personalizadas**: usa `{{callerName}}`, `{{callDuration}}` o `{{agentEmail}}` para personalizar tus flujos. * **Lógica condicional**: añade nodos IF o Switch para automatizaciones más complejas. * **Flujos encadenados**: combina Callin.io con CRMs y herramientas de mensajería en un proceso continuo. ## Solución de problemas **Síntoma:** error “Not Connected”\ **Causa probable:** revisa tus credenciales de n8n y los permisos de la integración. **Síntoma:** el flujo no se ejecuta\ **Causa probable:** asegúrate de que el workflow esté en **Active** en n8n. **Síntoma:** faltan datos\ **Causa probable:** verifica que todos los campos de Callin.io estén correctamente mapeados. ## Nota final Conectar Callin.io con n8n desbloquea un mundo de automatización inteligente.\ Empieza por algo simple —como enviar un mensaje a Slack después de cada llamada— y pronto verás cómo n8n convierte Callin.io en un hub de automatización realmente potente. # Collega n8n Source: https://support.callin.io/Create-AI-Agent/Connect-N8N-copied-3 Crea potenti automazioni tra Callin.io e i tuoi strumenti preferiti usando n8n. ## Panoramica Crea potenti automazioni tra Callin.io e i tuoi strumenti preferiti con n8n. ## Passaggi ### Passaggio 1: Cos’è n8n e perché usarlo con Callin.io? n8n (si pronuncia “en-eight-en”) è uno strumento di automazione dei flussi di lavoro che collega diverse app, facendole lavorare insieme in modo fluido. Con Callin.io, questa integrazione ti permette di: Inviare i dati delle chiamate (chiamante, agente, durata, registrazione, ecc.) ad app esterne. Creare automazioni come inviare avvisi su Slack dopo una chiamata o aggiungere i dati delle chiamate su Google Sheets. Attivare chiamate in uscita in base a eventi esterni, ad esempio un nuovo lead nel CRM. In breve: n8n trasforma le tue chiamate in trigger o azioni per qualsiasi flusso di automazione. ### Passaggio 2: Accedi al pannello integrazioni di Callin.io Accedi al tuo account Callin.io. Dal menu a sinistra, clicca **Actions**. Nella dashboard, seleziona la scheda **Automation** o **All Integrations**. Trova la card di n8n e clicca **Connect**. Verrai reindirizzato a una pagina di accesso come questa: [Integrazioni Callin.io](https://app.callin.io/actions) ### Passaggio 3: Accedi al tuo account n8n Si aprirà una nuova scheda con l’URL n8n.callin.io. Inserisci email e password di n8n. Se non hai ancora accesso, contatta l’amministratore Callin.io. Una volta dentro, vedrai il builder visuale dei workflow di n8n. ### Passaggio 4: Crea la tua prima automazione Clicca **+ New Workflow** e aggiungi i seguenti nodi: Trigger: seleziona “Callin.io → New Call” per avviare il flusso quando arriva una nuova chiamata. Action: aggiungi un’azione come: “Slack → Send Message” per avvisare il tuo team. “Google Sheets → Add Row” per registrare i dati della chiamata. “Webhook → POST” per inviare dati a un’app personalizzata. Exampio: ```json theme={null} { "Trigger": "Callin.io (New Call)", "Action": "Google Sheets (Add Row)", "Fields": ["Number", "Agent", "Duration", "Date"] } ``` ### Passaggio 5: Attiva e testa Salva il workflow. Attivalo usando l’interruttore **Active**. Esegui una chiamata di test da Callin.io e verifica che l’automazione funzioni. ## Suggerimenti e note * **Variabili personalizzate**: usa `{{callerName}}`, `{{callDuration}}` o `{{agentEmail}}` per personalizzare i tuoi flussi. * **Logica condizionale**: aggiungi nodi IF o Switch per automazioni più complesse. * **Flussi concatenati**: combina Callin.io con CRM e strumenti di messaggistica in un processo continuo. ## Risoluzione dei problemi **Sintomo:** errore “Not Connected”\ **Causa probabile:** controlla le credenziali n8n e i permessi dell’integrazione. **Sintomo:** il flusso non parte\ **Causa probabile:** assicurati che il workflow sia **Active** in n8n. **Sintomo:** dati mancanti\ **Causa probabile:** verifica che tutti i campi Callin.io siano mappati correttamente. ## Nota finale Collegare Callin.io a n8n sblocca un mondo di automazioni intelligenti.\ Inizia in piccolo — ad esempio inviando un messaggio Slack dopo ogni chiamata — e presto vedrai come n8n trasforma Callin.io in un hub di automazione davvero potente. # Connecter n8n Source: https://support.callin.io/Create-AI-Agent/Connect-N8N-copied-4 Créez des automatisations puissantes entre Callin.io et vos outils préférés avec n8n. ## Aperçu Créez des automatisations puissantes entre Callin.io et vos outils préférés avec n8n. ## Étapes ### Étape 1 : Qu’est-ce que n8n et pourquoi l’utiliser avec Callin.io ? n8n (prononcé « en-eight-en ») est un outil d’automatisation de workflows qui connecte différentes applications pour qu’elles fonctionnent ensemble de manière fluide. Avec Callin.io, cette intégration vous permet de : Envoyer des données d’appel (appelant, agent, durée, enregistrement, etc.) vers des applications externes. Créer des automatisations, comme envoyer des alertes Slack après un appel ou ajouter des données d’appel dans Google Sheets. Déclencher des appels sortants à partir d’événements externes, par exemple lorsqu’un nouveau lead CRM est créé. En bref : n8n transforme vos appels en déclencheurs (triggers) ou en actions pour n’importe quel flux d’automatisation. ### Étape 2 : Accéder au panneau d’intégrations Callin.io Connectez-vous à votre compte Callin.io. Dans le menu de gauche, cliquez sur Actions. Dans le tableau de bord, sélectionnez l’onglet Automation ou All Integrations. Trouvez la carte n8n et cliquez sur Connect. Vous serez redirigé vers une page de connexion comme celle-ci : [Callin.io Integrations](https://app.callin.io/actions) ### Étape 3 : Se connecter à votre compte n8n Un nouvel onglet s’ouvrira avec l’URL n8n.callin.io. Saisissez votre e-mail et votre mot de passe n8n. Si vous n’avez pas encore accès, contactez votre administrateur Callin.io. Une fois connecté, vous verrez l’interface visuelle de création de workflows n8n. ### Étape 4 : Créer votre première automatisation Cliquez sur + New Workflow et ajoutez les nœuds suivants : Trigger : Sélectionnez « Callin.io → New Call » pour démarrer le flux lorsqu’un nouvel appel arrive. Action : Ajoutez une action, par exemple : « Slack → Send Message » pour alerter votre équipe. « Google Sheets → Add Row » pour enregistrer les données d’appel. « Webhook → POST » pour envoyer les données à une application personnalisée. ### Étape 5 : Activer et tester Enregistrez le workflow. Activez-le via le bouton Active. Effectuez un appel de test depuis Callin.io et vérifiez que votre automatisation fonctionne. ## Conseils & remarques * **Variables personnalisées** : Utilisez callerName, callDuration ou agentEmail pour personnaliser vos flux. * **Logique conditionnelle** : Ajoutez des nœuds IF ou Switch pour des automatisations plus complexes. * **Flux chaînés** : Combinez Callin.io avec des CRM et des outils de messagerie dans un processus continu. ## Dépannage **Symptôme :** Erreur « Not Connected »\ **Cause probable :** Vérifiez vos identifiants n8n et les autorisations d’intégration. **Symptôme :** Le flux ne s’exécute pas\ **Cause probable :** Assurez-vous que le workflow est en mode Active dans n8n. **Symptôme :** Données manquantes\ **Cause probable :** Vérifiez que tous les champs Callin.io sont correctement mappés. ## Note finale Connecter Callin.io à n8n ouvre un univers d’automatisation intelligente.\ Commencez petit — par exemple en envoyant un message Slack après chaque appel — et vous verrez rapidement comment n8n transforme Callin.io en un hub d’automatisation intelligent. # Connect Zapier Source: https://support.callin.io/Create-AI-Agent/Connect-Zapier Learn how to integrate Callin.io with Zapier and create automations without coding. ## Before You Begin Zapier is a platform that connects different apps so they can work together automatically. These workflows are called Zaps.\ Each Zap follows a simple rule: when something happens in one app, an action runs in another. For instance, when your Callin.io agent finishes a call, Zapier can save the transcription in Google Sheets, send it by email, or post it in Slack. By connecting Callin.io with Zapier, you can: * Automatically receive call transcriptions. * Trigger outbound calls from your CRM or form tools. * Sync call and customer data without manual work. * Connect Callin.io with over 3,000 compatible applications. ## Step 1. Open the Integrations Panel in Callin.io Log in to your [Callin.io account](https://app.callin.io).\ From the left menu, open [Actions](https://app.callin.io/actions). Under **All Integrations**, find **Zapier** and click **Connect**.\ A new window will open, taking you to Zapier to complete the setup. ## Step 2. Sign In or Create Your Zapier Account If you already have a Zapier account, log in as usual.\ If not, you can create one for free at [zapier.com](https://zapier.com). Once inside, you’ll see an invitation to use **Callin.io** on Zapier.\ Click **“Accept Invite & Build a Zap”** to enable the integration. ## Step 3. Get Your API Key from Callin.io Zapier needs to verify your account securely using an API Key. To find it, open your [Callin.io profile](https://app.callin.io/profile?subSection=api).\ Select **API Keys** from the left menu. Copy the key shown in the **API Key** field.\ If you don’t have one or wish to renew it, click **Regenerate Key**.\ Keep your API Key safe. If it becomes compromised, regenerate it immediately. ## Step 4. Authorize the Connection in Zapier In Zapier, you’ll see the message **“Allow Zapier to access your Callin.io Account?”**\ Paste your API Key into the field.\ Click **“Yes, Continue to Callin.io.”** Your Callin.io account will now appear as connected. If you see **“This account connection is expired,”** click **Reconnect this account** and enter your current key again. ## Step 5. Build Your First Zap Let’s create your first automation: receiving call transcriptions automatically. In Zapier, click **Create Zap**.\ Under **App**, select **Callin.io (Draft)**.\ In **Trigger Event**, choose **Get Transcription**.\ Select your Callin.io account and click **Continue**. Now choose what happens next. For example: * Save the transcription to Google Sheets. * Send a message in Slack. * Create a record in your CRM such as HubSpot or Zoho. Every time a call ends, Zapier will automatically perform the chosen action. ## Advanced Configuration You can do much more with this integration: * Automatically initiate outbound calls when a new lead is created. * Sync call data with Airtable, Notion, or analytics platforms. * Send events to marketing tools for reporting or tracking. All integrations are managed from [Actions → Zapier](https://app.callin.io/actions) in your Callin.io dashboard. ## Common Issues and Solutions **Zap not triggering.**\ Check that your trigger event is correctly set and the Callin.io account is connected. **Invalid API Key or authentication error.**\ Regenerate a new key from the [API Keys section](https://app.callin.io/profile?subSection=api) and reconnect your account. **App appears as “Draft.”**\ This simply means the integration is in beta. It remains fully functional. ## Final Note By connecting Callin.io and Zapier, you can eliminate repetitive tasks and centralize your call data effortlessly.\ Once you build your first Zap, you’ll see how easy it is to automate call workflows, share transcriptions, and streamline your operations across all your favorite tools. # Zapier verbinden Source: https://support.callin.io/Create-AI-Agent/Connect-Zapier-copied-1 Erfahre, wie du Callin.io mit Zapier integrierst und Automatisierungen ohne Programmierung erstellst. ## Bevor du beginnst Zapier ist eine Plattform, die verschiedene Apps verbindet, damit sie automatisch zusammenarbeiten. Diese Workflows heißen Zaps.\ Jeder Zap folgt einer einfachen Regel: Wenn in einer App etwas passiert, wird in einer anderen App eine Aktion ausgeführt. Wenn dein Callin.io-Agent zum Beispiel einen Anruf beendet, kann Zapier die Transkription in Google Sheets speichern, per E-Mail senden oder in Slack posten. Durch die Verbindung von Callin.io mit Zapier kannst du: * Automatisch Anruf-Transkriptionen erhalten. * Ausgehende Anrufe aus deinem CRM oder aus Formular-Tools auslösen. * Anruf- und Kundendaten ohne manuelle Arbeit synchronisieren. * Callin.io mit über 3.000 kompatiblen Anwendungen verbinden. ## Schritt 1. Das Integrations-Panel in Callin.io öffnen Melde dich in deinem [Callin.io account](https://app.callin.io) an.\ Öffne im linken Menü [Actions](https://app.callin.io/actions). Suche unter **All Integrations** nach **Zapier** und klicke auf **Connect**.\ Es öffnet sich ein neues Fenster, das dich zu Zapier weiterleitet, um das Setup abzuschließen. ## Schritt 2. Bei Zapier anmelden oder ein Konto erstellen Wenn du bereits ein Zapier-Konto hast, melde dich wie gewohnt an.\ Wenn nicht, kannst du kostenlos eines auf [zapier.com](https://zapier.com) erstellen. Sobald du drin bist, siehst du eine Einladung, **Callin.io** in Zapier zu nutzen.\ Klicke auf **„Accept Invite & Build a Zap“**, um die Integration zu aktivieren. ## Schritt 3. Deinen API Key in Callin.io abrufen Zapier muss dein Konto sicher über einen API Key verifizieren. Um ihn zu finden, öffne dein [Callin.io profile](https://app.callin.io/profile?subSection=api).\ Wähle im linken Menü **API Keys**. Kopiere den Schlüssel im Feld **API Key**.\ Wenn du keinen hast oder ihn erneuern möchtest, klicke auf **Regenerate Key**.\ Bewahre deinen API Key sicher auf. Wenn er kompromittiert wird, regeneriere ihn sofort. ## Schritt 4. Die Verbindung in Zapier autorisieren In Zapier siehst du die Meldung **„Allow Zapier to access your Callin.io Account?“**\ Füge deinen API Key in das Feld ein.\ Klicke auf **„Yes, Continue to Callin.io.“** Dein Callin.io-Konto wird nun als verbunden angezeigt. Wenn du **„This account connection is expired“** siehst, klicke auf **Reconnect this account** und gib deinen aktuellen Key erneut ein. ## Schritt 5. Deinen ersten Zap erstellen Erstellen wir deine erste Automatisierung: Anruf-Transkriptionen automatisch empfangen. Klicke in Zapier auf **Create Zap**.\ Wähle unter **App** **Callin.io (Draft)** aus.\ Wähle bei **Trigger Event** **Get Transcription**.\ Wähle dein Callin.io-Konto aus und klicke auf **Continue**. Wähle jetzt, was als Nächstes passieren soll. Zum Beispiel: * Die Transkription in Google Sheets speichern. * Eine Nachricht in Slack senden. * Einen Datensatz in deinem CRM wie HubSpot oder Zoho erstellen. Jedes Mal, wenn ein Anruf endet, führt Zapier die ausgewählte Aktion automatisch aus. ## Erweiterte Konfiguration Mit dieser Integration kannst du noch viel mehr tun: * Ausgehende Anrufe automatisch starten, wenn ein neuer Lead erstellt wird. * Anrufdaten mit Airtable, Notion oder Analytics-Plattformen synchronisieren. * Events an Marketing-Tools senden, für Reporting oder Tracking. Alle Integrationen verwaltest du in deinem Callin.io-Dashboard unter [Actions → Zapier](https://app.callin.io/actions). ## Häufige Probleme und Lösungen **Zap wird nicht ausgelöst.**\ Prüfe, ob dein Trigger Event korrekt eingestellt ist und das Callin.io-Konto verbunden ist. **Ungültiger API Key oder Authentifizierungsfehler.**\ Generiere einen neuen Key im Bereich [API Keys section](https://app.callin.io/profile?subSection=api) und verbinde dein Konto erneut. **App erscheint als „Draft.“**\ Das bedeutet lediglich, dass die Integration in der Beta ist. Sie bleibt voll funktionsfähig. ## Abschlusshinweis Durch die Verbindung von Callin.io und Zapier kannst du repetitive Aufgaben eliminieren und deine Anrufdaten mühelos zentralisieren.\ Sobald du deinen ersten Zap erstellt hast, wirst du sehen, wie einfach es ist, Call-Workflows zu automatisieren, Transkriptionen zu teilen und deine Abläufe über all deine bevorzugten Tools hinweg zu optimieren. # Conectar Zapier Source: https://support.callin.io/Create-AI-Agent/Connect-Zapier-copied-2 Aprende a integrar Callin.io con Zapier y crear automatizaciones sin programar. ## Antes de empezar Zapier es una plataforma que conecta diferentes apps para que trabajen juntas automáticamente. Estos flujos de trabajo se llaman Zaps.\ Cada Zap sigue una regla simple: cuando ocurre algo en una app, se ejecuta una acción en otra. Por ejemplo, cuando tu agente de Callin.io termina una llamada, Zapier puede guardar la transcripción en Google Sheets, enviarla por email o publicarla en Slack. Al conectar Callin.io con Zapier, puedes: * Recibir transcripciones de llamadas automáticamente. * Disparar llamadas salientes desde tu CRM o herramientas de formularios. * Sincronizar datos de llamadas y clientes sin trabajo manual. * Conectar Callin.io con más de 3.000 aplicaciones compatibles. ## Paso 1. Abre el panel de integraciones en Callin.io Inicia sesión en tu [cuenta de Callin.io](https://app.callin.io).\ Desde el menú izquierdo, abre [Actions](https://app.callin.io/actions). En **All Integrations**, busca **Zapier** y haz clic en **Connect**.\ Se abrirá una nueva ventana que te llevará a Zapier para completar la configuración. ## Paso 2. Inicia sesión o crea tu cuenta de Zapier Si ya tienes una cuenta de Zapier, inicia sesión como siempre.\ Si no, puedes crear una gratis en [zapier.com](https://zapier.com). Una vez dentro, verás una invitación para usar **Callin.io** en Zapier.\ Haz clic en **“Accept Invite & Build a Zap”** para habilitar la integración. ## Paso 3. Obtén tu API Key en Callin.io Zapier necesita verificar tu cuenta de forma segura usando una API Key. Para encontrarla, abre tu [perfil de Callin.io](https://app.callin.io/profile?subSection=api).\ Selecciona **API Keys** en el menú izquierdo. Copia la clave que aparece en el campo **API Key**.\ Si no tienes una o quieres renovarla, haz clic en **Regenerate Key**.\ Mantén tu API Key segura. Si se ve comprometida, regénérala inmediatamente. ## Paso 4. Autoriza la conexión en Zapier En Zapier, verás el mensaje **“Allow Zapier to access your Callin.io Account?”**\ Pega tu API Key en el campo.\ Haz clic en **“Yes, Continue to Callin.io.”** Tu cuenta de Callin.io aparecerá ahora como conectada. Si ves **“This account connection is expired,”** haz clic en **Reconnect this account** y vuelve a introducir tu clave actual. ## Paso 5. Crea tu primer Zap Vamos a crear tu primera automatización: recibir transcripciones de llamadas automáticamente. En Zapier, haz clic en **Create Zap**.\ En **App**, selecciona **Callin.io (Draft)**.\ En **Trigger Event**, elige **Get Transcription**.\ Selecciona tu cuenta de Callin.io y haz clic en **Continue**. Ahora elige qué sucede después. Por ejemplo: * Guardar la transcripción en Google Sheets. * Enviar un mensaje en Slack. * Crear un registro en tu CRM como HubSpot o Zoho. Cada vez que termine una llamada, Zapier ejecutará automáticamente la acción elegida. ## Configuración avanzada Puedes hacer mucho más con esta integración: * Iniciar llamadas salientes automáticamente cuando se crea un nuevo lead. * Sincronizar datos de llamadas con Airtable, Notion o plataformas de analítica. * Enviar eventos a herramientas de marketing para reporting o tracking. Todas las integraciones se gestionan desde [Actions → Zapier](https://app.callin.io/actions) en tu panel de Callin.io. ## Problemas comunes y soluciones **El Zap no se dispara.**\ Comprueba que el evento trigger esté correctamente configurado y que la cuenta de Callin.io esté conectada. **API Key inválida o error de autenticación.**\ Genera una clave nueva desde la [sección de API Keys](https://app.callin.io/profile?subSection=api) y vuelve a conectar tu cuenta. **La app aparece como “Draft.”**\ Esto solo significa que la integración está en beta. Sigue siendo totalmente funcional. ## Nota final Al conectar Callin.io con Zapier, puedes eliminar tareas repetitivas y centralizar tus datos de llamadas sin esfuerzo.\ Cuando crees tu primer Zap, verás lo fácil que es automatizar flujos de llamadas, compartir transcripciones y optimizar tus operaciones en todas tus herramientas favoritas. # Connettere Zapier Source: https://support.callin.io/Create-AI-Agent/Connect-Zapier-copied-3 Scopri come integrare Callin.io con Zapier e creare automazioni senza scrivere codice. ## Prima di iniziare Zapier è una piattaforma che collega diverse app in modo che possano lavorare insieme automaticamente. Questi flussi di lavoro si chiamano **Zap**.\ Ogni Zap segue una regola semplice: quando succede qualcosa in un’app, viene eseguita un’azione in un’altra. Per esempio, quando il tuo agente Callin.io termina una chiamata, Zapier può salvare la trascrizione in Google Sheets, inviarla via email oppure pubblicarla su Slack. Collegando Callin.io a Zapier, puoi: * Ricevere automaticamente le trascrizioni delle chiamate. * Avviare chiamate in uscita dal tuo CRM o da strumenti per moduli. * Sincronizzare dati di chiamate e clienti senza lavoro manuale. * Collegare Callin.io con oltre 3.000 applicazioni compatibili. ## Passo 1. Apri il pannello integrazioni in Callin.io Accedi al tuo [account Callin.io](https://app.callin.io).\ Dal menu a sinistra, apri [Actions](https://app.callin.io/actions). In **All Integrations**, trova **Zapier** e fai clic su **Connect**.\ Si aprirà una nuova finestra che ti porterà su Zapier per completare la configurazione. ## Passo 2. Accedi o crea il tuo account Zapier Se hai già un account Zapier, accedi come al solito.\ Se non ce l’hai, puoi crearne uno gratuitamente su [zapier.com](https://zapier.com). Una volta dentro, vedrai un invito a usare **Callin.io** su Zapier.\ Fai clic su **“Accept Invite & Build a Zap”** per abilitare l’integrazione. ## Passo 3. Ottieni la tua API Key da Callin.io Zapier deve verificare il tuo account in modo sicuro tramite una **API Key**. Per trovarla, apri il tuo [profilo Callin.io](https://app.callin.io/profile?subSection=api).\ Seleziona **API Keys** dal menu a sinistra. Copia la chiave mostrata nel campo **API Key**.\ Se non ne hai una o vuoi rinnovarla, fai clic su **Regenerate Key**.\ Mantieni la tua API Key al sicuro: se viene compromessa, rigenerala immediatamente. ## Passo 4. Autorizza la connessione in Zapier In Zapier vedrai il messaggio **“Allow Zapier to access your Callin.io Account?”**\ Incolla la tua API Key nel campo.\ Fai clic su **“Yes, Continue to Callin.io.”** Il tuo account Callin.io risulterà ora connesso. Se vedi **“This account connection is expired,”** fai clic su **Reconnect this account** e inserisci di nuovo la chiave attuale. ## Passo 5. Crea il tuo primo Zap Creiamo la tua prima automazione: ricevere automaticamente le trascrizioni delle chiamate. In Zapier, fai clic su **Create Zap**.\ In **App**, seleziona **Callin.io (Draft)**.\ In **Trigger Event**, scegli **Get Transcription**.\ Seleziona il tuo account Callin.io e fai clic su **Continue**. Ora scegli cosa deve succedere dopo. Per esempio: * Salvare la trascrizione in Google Sheets. * Inviare un messaggio su Slack. * Creare un record nel tuo CRM come HubSpot o Zoho. Ogni volta che una chiamata termina, Zapier eseguirà automaticamente l’azione scelta. ## Configurazione avanzata Con questa integrazione puoi fare molto di più: * Avviare automaticamente chiamate in uscita quando viene creato un nuovo lead. * Sincronizzare i dati delle chiamate con Airtable, Notion o piattaforme di analytics. * Inviare eventi a strumenti di marketing per reportistica o tracciamento. Tutte le integrazioni si gestiscono da [Actions → Zapier](https://app.callin.io/actions) nella dashboard di Callin.io. ## Problemi comuni e soluzioni **Lo Zap non si attiva.**\ Verifica che l’evento di trigger sia impostato correttamente e che l’account Callin.io sia connesso. **API Key non valida o errore di autenticazione.**\ Rigenera una nuova chiave nella sezione [API Keys](https://app.callin.io/profile?subSection=api) e riconnetti l’account. **L’app appare come “Draft.”**\ Significa semplicemente che l’integrazione è in beta. Rimane comunque pienamente funzionante. ## Nota finale Collegando Callin.io e Zapier puoi eliminare attività ripetitive e centralizzare i dati delle chiamate senza sforzo.\ Dopo aver creato il tuo primo Zap, vedrai quanto è semplice automatizzare i flussi di chiamata, condividere le trascrizioni e ottimizzare le operazioni con tutti i tuoi strumenti preferiti. # Connecter Zapier Source: https://support.callin.io/Create-AI-Agent/Connect-Zapier-copied-4 Apprenez à intégrer Callin.io à Zapier et à créer des automatisations sans coder. ## Avant de commencer Zapier est une plateforme qui connecte différentes applications afin qu’elles fonctionnent ensemble automatiquement. Ces workflows s’appellent des **Zaps**.\ Chaque Zap suit une règle simple : lorsqu’un événement se produit dans une application, une action s’exécute dans une autre. Par exemple, lorsque votre agent Callin.io termine un appel, Zapier peut enregistrer la transcription dans Google Sheets, l’envoyer par e-mail ou la publier dans Slack. En connectant Callin.io à Zapier, vous pouvez : * Recevoir automatiquement les transcriptions d’appels. * Déclencher des appels sortants depuis votre CRM ou vos outils de formulaires. * Synchroniser les données d’appel et les données client sans travail manuel. * Connecter Callin.io à plus de 3 000 applications compatibles. ## Étape 1. Ouvrir le panneau des intégrations dans Callin.io Connectez-vous à votre [compte Callin.io](https://app.callin.io).\ Dans le menu de gauche, ouvrez [Actions](https://app.callin.io/actions). Sous **All Integrations**, trouvez **Zapier** et cliquez sur **Connect**.\ Une nouvelle fenêtre s’ouvrira et vous redirigera vers Zapier pour terminer la configuration. ## Étape 2. Se connecter ou créer un compte Zapier Si vous avez déjà un compte Zapier, connectez-vous normalement.\ Sinon, vous pouvez en créer un gratuitement sur [zapier.com](https://zapier.com). Une fois connecté, vous verrez une invitation pour utiliser **Callin.io** sur Zapier.\ Cliquez sur **« Accept Invite & Build a Zap »** pour activer l’intégration. ## Étape 3. Récupérer votre clé API dans Callin.io Zapier doit vérifier votre compte de manière sécurisée à l’aide d’une **clé API**. Pour la trouver, ouvrez votre [profil Callin.io](https://app.callin.io/profile?subSection=api).\ Sélectionnez **API Keys** dans le menu de gauche. Copiez la clé affichée dans le champ **API Key**.\ Si vous n’en avez pas ou si vous souhaitez la renouveler, cliquez sur **Regenerate Key**.\ Gardez votre clé API en sécurité. Si elle est compromise, régénérez-la immédiatement. ## Étape 4. Autoriser la connexion dans Zapier Dans Zapier, vous verrez le message **« Allow Zapier to access your Callin.io Account? »**\ Collez votre clé API dans le champ prévu.\ Cliquez sur **« Yes, Continue to Callin.io. »** Votre compte Callin.io apparaîtra alors comme connecté. Si vous voyez **« This account connection is expired »**, cliquez sur **Reconnect this account** et saisissez à nouveau votre clé actuelle. ## Étape 5. Créer votre premier Zap Créons votre première automatisation : recevoir automatiquement les transcriptions d’appels. Dans Zapier, cliquez sur **Create Zap**.\ Sous **App**, sélectionnez **Callin.io (Draft)**.\ Dans **Trigger Event**, choisissez **Get Transcription**.\ Sélectionnez votre compte Callin.io, puis cliquez sur **Continue**. Choisissez ensuite ce qui doit se passer. Par exemple : * Enregistrer la transcription dans Google Sheets. * Envoyer un message dans Slack. * Créer un enregistrement dans votre CRM (HubSpot ou Zoho, par exemple). À chaque fin d’appel, Zapier exécutera automatiquement l’action choisie. ## Configuration avancée Vous pouvez faire bien plus avec cette intégration : * Lancer automatiquement des appels sortants lorsqu’un nouveau lead est créé. * Synchroniser les données d’appels avec Airtable, Notion ou des plateformes d’analytics. * Envoyer des événements vers des outils marketing pour le reporting ou le tracking. Toutes les intégrations se gèrent depuis [Actions → Zapier](https://app.callin.io/actions) dans votre tableau de bord Callin.io. ## Problèmes courants et solutions **Le Zap ne se déclenche pas.**\ Vérifiez que l’événement déclencheur est correctement configuré et que le compte Callin.io est bien connecté. **Clé API invalide ou erreur d’authentification.**\ Régénérez une nouvelle clé dans la [section API Keys](https://app.callin.io/profile?subSection=api) et reconnectez votre compte. **L’application apparaît comme « Draft ».**\ Cela signifie simplement que l’intégration est en bêta. Elle reste entièrement fonctionnelle. ## Note finale En connectant Callin.io à Zapier, vous pouvez éliminer les tâches répétitives et centraliser vos données d’appels sans effort.\ Une fois votre premier Zap créé, vous verrez à quel point il est simple d’automatiser vos workflows d’appels, de partager des transcriptions et d’optimiser vos opérations avec tous vos outils préférés. # How to connect your number to Callin Source: https://support.callin.io/Create-AI-Agent/ConnectNumber Learn the three ways to connect your existing business number to a Callin agent: call forwarding, porting, or BYOC. ## Connect your existing number to an agent If your business already has a phone number and you want an AI agent to answer calls on that line, you do not need to rebuild your entire phone setup to get started. In Callin, you can do it in three different ways depending on the level of integration you need and the phone infrastructure you already have. You can connect your existing number through: * **Call forwarding**, if you want to keep your current line and redirect calls to the agent’s number. * **Porting**, if you want to keep the same number and request its migration through the flow compatible with Callin. * **BYOC (SIP Trunk)**, if you already work with a SIP carrier, PBX, or phone system and want to connect that infrastructure to the platform. The best option depends on whether you want speed, continuity with your current number, or a more advanced technical setup. ## Where each option is managed Everything related to buying numbers, starting a porting request, and managing numbers is handled from the **Numbers** section. Connecting your own carrier, SIP Trunks, or external providers is handled from the **BYOC** section. If your goal is to use an existing number with an agent, you will usually start in **Numbers** and move to **BYOC** if you need a more advanced telephony integration. ## Option 1: Keep your current number and use call forwarding This is the fastest and simplest way to get started. With this option, your main number stays with your current phone provider. It is not transferred and it is not migrated. Instead, you connect a number in Callin, assign it to your agent, and then enable call forwarding from your usual business number to that agent number. When someone calls your main line, the call is redirected to the number connected to the agent, and the agent answers it. ### How it works First, you need an active number in **Numbers**. That will be the number used by the agent. Then you assign that number to the correct agent. Once that is done, you enable forwarding from your original number to the agent number. From that point on, your customers can keep calling the same number they already know, while the agent handles the call. ### What you need to know Call forwarding is not enabled inside Callin. Callin receives the call on the number assigned to the agent, but enabling the forwarding itself depends on the customer and their phone carrier. This means the user must configure it from their phone, through their PBX, or with their telecom provider depending on how their current line is managed. ### When this option makes sense This option is ideal if you want to move quickly, keep your public business number unchanged, and avoid a more technical process or a number migration. It is also a very practical solution if you want to start using the agent in production without changing your main telephony structure yet. ### Practical example A clinic has used the same landline number for years. That number appears on its website, in Google listings, and across all its business communications. Instead of changing it, the clinic buys a number in Callin through **Numbers**, assigns it to its agent, and enables forwarding from the main line through its phone carrier. Patients keep calling the same number, but the agent is the one answering. ### Advantages * It is the fastest option to activate. * It lets you keep the number your customers already know. * It does not require moving your number to a different setup. * It is easy to understand and easy to implement. ### Important considerations Forwarding depends on your carrier. Some providers allow it from a customer portal or directly from the phone, while others require a specific request. Depending on your plan, there may also be charges associated with forwarded calls. > **Important:** Call forwarding is configured with your phone carrier or internal phone system, not inside Callin. ## Option 2: Port your number Porting allows you to keep your current number and request that it continue operating through the flow compatible with Callin, instead of relying on permanent forwarding. This option is a strong fit when you want to keep the same customer-facing number but prefer a more direct integration.Screenshot: the porting request flow in Numbers, where the user enters an existing phone number and checks whether it is eligible to continue.
### Where it starts A porting request starts from **Numbers**. Inside the request flow, you can choose between requesting a new number or starting a porting request. To continue through this option, you select porting, choose the country, select the available number type, and enter the number you want to port. ### How it works Once the number is entered, the platform performs a portability check to verify whether that number can continue through the process. This validation confirms whether coverage or availability exists for that request. Not all numbers can be ported in all countries, and not all number types follow the same rules. ### What happens if the number is not compatible If the number cannot continue, the platform will clearly indicate that coverage is not available for that phone number. That does not necessarily mean the number is invalid. It means that, in that case, the number cannot continue through the available porting flow. ### What happens if the number is compatible If the number is eligible, the request can continue. The next steps may vary depending on the country, the number type, and the conditions that apply to that case. ### When this option makes sense Porting is a good choice when you want to keep using your current number but do not want to rely on external forwarding as a long-term solution. It is also the natural path when your main number is already part of your brand and you want to integrate it more directly into your operating model. ### Practical example A professional firm has used the same business number for years. Its clients know it, and changing it would create friction. In that case, porting allows the firm to keep that number as its main point of contact while moving toward a more integrated setup. ### Advantages * It allows you to keep the number your business already uses. * It avoids depending on external forwarding as a permanent solution. * It offers a more natural continuity for both customers and internal teams. ### Important considerations Porting depends on eligibility. Availability may vary depending on the country, the number type, and the coverage associated with the number. That is why the process always begins with a check from **Numbers**. > **Tip:** If your number does not pass the availability check, call forwarding may still be the fastest way to start using the agent. ## Option 3: Connect your infrastructure with BYOC (SIP Trunk) BYOC stands for Bring Your Own Carrier. This option allows you to connect your own telephony provider to Callin so the agent can operate on top of your existing infrastructure. It is the most advanced option and is designed for businesses that already use VoIP, a PBX, a phone system, or their own SIP provider. ### Where it is configured All custom carrier setup is managed from **BYOC**. From this section, you can connect Telnyx or configure a generic SIP Trunk with another provider. ### When it makes sense BYOC is the best choice when your company already has a business telephony setup and does not want to duplicate systems or rebuild its voice architecture. It is also recommended if you need more control over how calls enter and leave the platform, or if your technical team already works with SIP trunks and its own credentials. ### BYOC with Telnyx If you already use Telnyx, you can connect it from **BYOC** using an API key. After the account is connected, the platform retrieves your active numbers, adds them to your workspace, and prepares the connection required for inbound and outbound calls. ### When to choose this option This is the best path if you already have active numbers in Telnyx and want to integrate them with Callin in a more guided and faster way. ### Practical example A company already uses Telnyx for its business telephony. Instead of buying new numbers, it connects Telnyx from **BYOC**, imports its numbers, and continues working with the number inventory it already has in production. ### BYOC with another SIP provider If your provider is not Telnyx, you can use the generic setup available in **BYOC**. This option allows you to connect a SIP Trunk from another provider and define how inbound and outbound calls will be handled. ### What is defined in this setup First, you define the basic trunk details and the number you want to use. Then you configure the inbound side, which determines where incoming calls should be delivered. Finally, you configure the outbound side, which defines which server and credentials will be used for outbound calling. ### In simple terms The inbound part determines where your system receives calls. The outbound part determines how calls leave the platform. This separation is common in business telephony environments and gives you more operational control. ### When to use this option This is the best path when your company already works with a different SIP provider, when you have your own PBX, or when you need to maintain an existing corporate telephony architecture. ### Practical example An international company works with a SIP provider that already manages its numbers, routing, and internal rules. Instead of rebuilding its entire phone environment, it connects that trunk from **BYOC** and allows the agent to operate within that existing setup.Screenshot: the BYOC section, where users connect their existing carrier, import numbers, or configure a SIP Trunk for inbound and outbound calls.
> **Important:** BYOC is recommended for businesses that already have a telephony team, SIP provider, or existing PBX setup. ## Assign the number to the agent Having the number in your workspace is not the last step. For the agent to use it, the number must be assigned to the correct agent. This assignment is part of the actual activation of the line. If the number exists in your account but has not been assigned, it is not yet ready to work as the agent’s active phone line. ### Where it is managed The number itself is managed from **Numbers**, but assignment is also part of the agent’s operating setup. ### Why it matters A number can be correctly purchased, connected, or imported and still not behave as expected if it is not linked to the right agent. ### Practical example If your company has one agent for support and another for sales, you must make sure each number is assigned to the correct one. This avoids a situation where a line meant for sales is answered by the support flow, or the other way around. > **Common mistake:** Importing or buying a number is not enough on its own. The number still needs to be assigned to the correct agent. ## Which option should you choose If you want a simple recommendation: * If you want to get started quickly without changing your main number, use call forwarding. * If you want to keep that number inside a more integrated operating model, use porting when it is available. * If your company already has its own telephony infrastructure, use BYOC. The best option is the one that fits your current operations, your provider, and the level of control you want to keep. # Comment connecter votre numéro à Callin Source: https://support.callin.io/Create-AI-Agent/ConnectNumberFrench Découvrez les trois façons de connecter votre numéro d’entreprise existant à un agent Callin : transfert d’appel, portabilité ou BYOC. ## Connectez votre numéro existant à un agent Si votre entreprise possède déjà un numéro de téléphone et que vous voulez qu’un agent IA réponde aux appels sur cette ligne, vous n’avez pas besoin de reconstruire toute votre configuration téléphonique pour commencer. Dans Callin, vous pouvez le faire de trois façons différentes selon le niveau d’intégration dont vous avez besoin et l’infrastructure téléphonique dont vous disposez déjà. Vous pouvez connecter votre numéro existant via : * **Le transfert d’appel**, si vous voulez conserver votre ligne actuelle et rediriger les appels vers le numéro de l’agent. * **La portabilité**, si vous voulez conserver le même numéro et demander sa migration via le parcours compatible avec Callin. * **BYOC (tronc SIP)**, si vous travaillez déjà avec un opérateur SIP, un standard téléphonique ou un système téléphonique et que vous souhaitez connecter cette infrastructure à la plateforme. Le meilleur choix dépend de votre besoin de rapidité, de continuité avec votre numéro actuel ou d’une configuration technique plus avancée. ## Où chaque option est gérée Tout ce qui concerne l’achat de numéros, le démarrage d’une demande de portabilité et la gestion des numéros est géré depuis la section [**Numéros**](https://app.callin.io/numbers). La connexion de votre propre opérateur, des troncs SIP ou de fournisseurs externes est gérée depuis la section [**BYOC**](https://app.callin.io/byoc). Si votre objectif est d’utiliser un numéro existant avec un agent, vous commencerez généralement dans [**Numéros**](https://app.callin.io/numbers) puis vous passerez à [**BYOC**](https://app.callin.io/byoc) si vous avez besoin d’une intégration téléphonique plus avancée. ## Option 1 : Conserver votre numéro actuel et utiliser le transfert d’appel C’est la façon la plus rapide et la plus simple de commencer. Avec cette option, votre numéro principal reste chez votre opérateur téléphonique actuel. Il n’est ni transféré ni migré. À la place, vous connectez un numéro dans Callin, vous l’assignez à votre agent, puis vous activez le transfert d’appel depuis votre numéro professionnel habituel vers le numéro de l’agent. Quand quelqu’un appelle votre ligne principale, l’appel est redirigé vers le numéro connecté à l’agent, et l’agent répond. ### Comment cela fonctionne Vous avez d’abord besoin d’un numéro actif dans [**Numéros**](https://app.callin.io/numbers). Ce sera le numéro utilisé par l’agent. Ensuite, vous assignez ce numéro au bon agent. Une fois cela fait, vous activez le transfert depuis votre numéro d’origine vers le numéro de l’agent. À partir de ce moment, vos clients peuvent continuer à appeler le même numéro qu’ils connaissent déjà, pendant que l’agent prend l’appel en charge. ### Ce que vous devez savoir Le transfert d’appel n’est pas activé dans Callin. Callin reçoit l’appel sur le numéro assigné à l’agent, mais l’activation du transfert dépend du client et de son opérateur téléphonique. Cela signifie que l’utilisateur doit le configurer depuis son téléphone, via son standard téléphonique ou avec son fournisseur télécom, selon la manière dont sa ligne actuelle est gérée. ### Quand cette option a du sens Cette option est idéale si vous voulez avancer rapidement, garder votre numéro public inchangé et éviter un processus plus technique ou une migration du numéro. C’est aussi une solution très pratique si vous voulez commencer à utiliser l’agent en production sans modifier immédiatement votre structure téléphonique principale. ### Exemple concret Une clinique utilise le même numéro fixe depuis des années. Ce numéro apparaît sur son site web, dans ses fiches Google et dans toutes ses communications professionnelles. Au lieu de le changer, la clinique achète un numéro dans Callin via [**Numéros**](https://app.callin.io/numbers), l’assigne à son agent et active le transfert depuis la ligne principale via son opérateur téléphonique. Les patients continuent d’appeler le même numéro, mais c’est l’agent qui répond. ### Avantages * C’est l’option la plus rapide à activer. * Elle vous permet de conserver le numéro que vos clients connaissent déjà. * Elle ne nécessite pas de déplacer votre numéro vers une autre configuration. * Elle est facile à comprendre et facile à mettre en place. ### Points importants Le transfert dépend de votre opérateur. Certains fournisseurs l’autorisent depuis un portail client ou directement depuis le téléphone, tandis que d’autres exigent une demande spécifique. Selon votre offre, des frais peuvent également s’appliquer aux appels transférés. > **Important :** Le transfert d’appel se configure avec votre opérateur téléphonique ou votre système téléphonique interne, pas dans Callin. ## Option 2 : Porter votre numéro La portabilité vous permet de conserver votre numéro actuel et de demander qu’il continue de fonctionner via le parcours compatible avec Callin, au lieu de dépendre d’un transfert permanent. Cette option convient particulièrement si vous voulez garder le même numéro visible pour vos clients tout en préférant une intégration plus directe. ### Où cela commence Une demande de portabilité commence dans [**Numéros**](https://app.callin.io/numbers). Dans le parcours de demande, vous pouvez choisir entre demander un nouveau numéro ou démarrer une demande de portabilité. Pour continuer avec cette option, vous sélectionnez la portabilité, choisissez le pays, sélectionnez le type de numéro disponible et saisissez le numéro que vous souhaitez porter.Capture : écran de la demande de portabilité, où l’utilisateur saisit son numéro et vérifie s’il peut continuer.
### Comment cela fonctionne Une fois le numéro saisi, la plateforme effectue une vérification de portabilité pour confirmer si ce numéro peut poursuivre le processus. Cette vérification confirme s’il existe une couverture ou une disponibilité pour cette demande. Tous les numéros ne peuvent pas être portés dans tous les pays, et tous les types de numéros ne suivent pas les mêmes règles. ### Que se passe-t-il si le numéro n’est pas compatible Si le numéro ne peut pas continuer, la plateforme indiquera clairement qu’aucune couverture n’est disponible pour ce numéro de téléphone. Cela ne signifie pas nécessairement que le numéro est invalide. Cela signifie que, dans ce cas, le numéro ne peut pas continuer dans le parcours de portabilité disponible. ### Que se passe-t-il si le numéro est compatible Si le numéro est éligible, la demande peut continuer. Les étapes suivantes peuvent varier selon le pays, le type de numéro et les conditions applicables à ce cas. ### Quand cette option a du sens La portabilité est un bon choix si vous voulez continuer à utiliser votre numéro actuel sans dépendre du transfert externe comme solution à long terme. C’est aussi la voie naturelle lorsque votre numéro principal fait déjà partie de votre marque et que vous souhaitez l’intégrer plus directement dans votre modèle opérationnel. ### Exemple concret Un cabinet professionnel utilise le même numéro d’entreprise depuis des années. Ses clients le connaissent, et le changer créerait des frictions. Dans ce cas, la portabilité permet au cabinet de conserver ce numéro comme point de contact principal tout en évoluant vers une configuration plus intégrée. ### Avantages * Elle vous permet de conserver le numéro que votre entreprise utilise déjà. * Elle évite de dépendre du transfert externe comme solution permanente. * Elle offre une continuité plus naturelle, à la fois pour les clients et pour les équipes internes. ### Points importants La portabilité dépend de l’éligibilité. La disponibilité peut varier selon le pays, le type de numéro et la couverture associée au numéro. C’est pourquoi le processus commence toujours par une vérification dans [**Numéros**](https://app.callin.io/numbers). > **Conseil :** Si votre numéro ne passe pas la vérification de disponibilité, le transfert d’appel peut rester le moyen le plus rapide de commencer à utiliser l’agent. ## Option 3 : Connecter votre infrastructure avec BYOC (tronc SIP) BYOC vous permet de connecter votre propre fournisseur téléphonique à Callin afin que l’agent puisse fonctionner sur votre infrastructure existante. C’est l’option la plus avancée, conçue pour les entreprises qui utilisent déjà la voix sur IP, un standard téléphonique, un système téléphonique ou leur propre fournisseur SIP. ### Où cela se configure Toute la configuration des opérateurs personnalisés est gérée depuis la section [**BYOC**](https://app.callin.io/byoc). Depuis cette section, vous pouvez connecter Telnyx ou configurer un tronc SIP générique avec un autre fournisseur.Capture : section BYOC, où les utilisateurs connectent leur opérateur existant, importent des numéros ou configurent un tronc SIP.
### Quand cela a du sens BYOC est le meilleur choix lorsque votre entreprise dispose déjà d’une configuration téléphonique professionnelle et ne veut ni dupliquer les systèmes ni reconstruire son architecture vocale. Cette option est également recommandée si vous avez besoin de plus de contrôle sur la façon dont les appels entrent et sortent de la plateforme, ou si votre équipe technique travaille déjà avec des troncs SIP et ses propres identifiants. ### BYOC avec Telnyx Si vous utilisez déjà Telnyx, vous pouvez le connecter depuis [**BYOC**](https://app.callin.io/byoc) à l’aide d’une clé d’API. Une fois le compte connecté, la plateforme récupère vos numéros actifs, les ajoute à votre espace de travail et prépare la connexion nécessaire pour les appels entrants et sortants. ### Quand choisir cette option C’est la meilleure voie si vous avez déjà des numéros actifs dans Telnyx et que vous souhaitez les intégrer à Callin de manière plus guidée et plus rapide. ### Exemple concret Une entreprise utilise déjà Telnyx pour sa téléphonie professionnelle. Au lieu d’acheter de nouveaux numéros, elle connecte Telnyx depuis [**BYOC**](https://app.callin.io/byoc), importe ses numéros et continue à travailler avec l’inventaire de numéros qu’elle utilise déjà en production. ### BYOC avec un autre fournisseur SIP Si votre fournisseur n’est pas Telnyx, vous pouvez utiliser la configuration générique disponible dans [**BYOC**](https://app.callin.io/byoc). Cette option vous permet de connecter un tronc SIP d’un autre fournisseur et de définir la manière dont les appels entrants et sortants seront gérés. ### Ce qui est défini dans cette configuration Vous définissez d’abord les informations de base du tronc et le numéro que vous voulez utiliser. Ensuite, vous configurez la partie entrante, qui détermine où les appels entrants doivent être remis. Enfin, vous configurez la partie sortante, qui définit quel serveur et quels identifiants seront utilisés pour les appels sortants. ### En termes simples La partie entrante détermine où votre système reçoit les appels.\ La partie sortante détermine comment les appels quittent la plateforme. Cette séparation est courante dans les environnements de téléphonie professionnelle et vous donne davantage de contrôle opérationnel. ### Quand utiliser cette option C’est la meilleure voie lorsque votre entreprise travaille déjà avec un autre fournisseur SIP, lorsque vous avez votre propre standard téléphonique ou lorsque vous devez conserver une architecture téléphonique d’entreprise existante. ### Exemple concret Une entreprise internationale travaille avec un fournisseur SIP qui gère déjà ses numéros, son routage et ses règles internes. Au lieu de reconstruire tout son environnement téléphonique, elle connecte ce tronc depuis [**BYOC**](https://app.callin.io/byoc) et permet à l’agent de fonctionner dans cette configuration existante. > **Important :** BYOC est recommandé pour les entreprises qui disposent déjà d’une équipe téléphonique, d’un fournisseur SIP ou d’une configuration de standard existante. ## Attribuer le numéro à l’agent Le fait d’avoir le numéro dans votre espace de travail n’est pas la dernière étape. Pour que l’agent puisse l’utiliser, le numéro doit être attribué au bon agent. Cette attribution fait partie de l’activation réelle de la ligne. Si le numéro existe dans votre compte mais n’a pas été attribué, il n’est pas encore prêt à fonctionner comme ligne téléphonique active de l’agent. ### Où cela se gère Le numéro lui-même est géré depuis [**Numéros**](https://app.callin.io/numbers), mais l’attribution fait aussi partie de la configuration opérationnelle de l’agent. ### Pourquoi c’est important Un numéro peut être correctement acheté, connecté ou importé et pourtant ne pas se comporter comme prévu s’il n’est pas lié au bon agent. ### Exemple concret Si votre entreprise a un agent pour l’assistance et un autre pour les ventes, vous devez vous assurer que chaque numéro est attribué au bon agent. Cela évite qu’une ligne destinée aux ventes soit traitée par le parcours d’assistance, ou l’inverse. > **Erreur courante :** Importer ou acheter un numéro ne suffit pas à lui seul. Le numéro doit encore être attribué au bon agent. ## Quelle option devriez-vous choisir Si vous voulez une recommandation simple : * Si vous voulez commencer rapidement sans changer votre numéro principal, utilisez le transfert d’appel. * Si vous voulez conserver ce numéro dans un modèle opérationnel plus intégré, utilisez la portabilité lorsqu’elle est disponible. * Si votre entreprise dispose déjà de sa propre infrastructure téléphonique, utilisez BYOC. Le meilleur choix est celui qui correspond à vos opérations actuelles, à votre fournisseur et au niveau de contrôle que vous souhaitez conserver. # So verbindest du deine Nummer mit Callin Source: https://support.callin.io/Create-AI-Agent/ConnectNumberGerman Lerne die drei Möglichkeiten kennen, deine bestehende Unternehmensnummer mit einem Callin-Agenten zu verbinden: Rufweiterleitung, Portierung oder BYOC. ## Verbinde deine bestehende Nummer mit einem Agenten Wenn dein Unternehmen bereits eine Telefonnummer hat und du möchtest, dass ein KI-Agent Anrufe auf dieser Leitung beantwortet, musst du nicht deine komplette Telefonstruktur neu aufbauen, um loszulegen. In Callin kannst du das auf drei verschiedene Arten tun, je nachdem, wie tief die Integration sein soll und welche Telefoninfrastruktur du bereits nutzt. Du kannst deine bestehende Nummer auf folgende Weise verbinden: * **Rufweiterleitung**, wenn du deine aktuelle Leitung behalten und Anrufe an die Nummer des Agenten weiterleiten möchtest. * **Portierung**, wenn du dieselbe Nummer behalten und ihre Übertragung über den mit Callin kompatiblen Ablauf beantragen möchtest. * **BYOC (SIP-Trunk)**, wenn du bereits mit einem SIP-Anbieter, einer Telefonanlage oder einem Telefonsystem arbeitest und diese Infrastruktur mit der Plattform verbinden möchtest. Welche Option am besten ist, hängt davon ab, ob du Geschwindigkeit, Kontinuität mit deiner aktuellen Nummer oder eine fortgeschrittenere technische Einrichtung möchtest. ## Wo jede Option verwaltet wird Alles rund um den Kauf von Nummern, das Starten einer Portierungsanfrage und die Verwaltung von Nummern wird im Bereich [**Nummern**](https://app.callin.io/numbers) verwaltet. Die Verbindung deines eigenen Anbieters, von SIP-Trunks oder externen Anbietern wird im Bereich [**BYOC**](https://app.callin.io/byoc) verwaltet. Wenn dein Ziel ist, eine bestehende Nummer mit einem Agenten zu verwenden, startest du in der Regel in [**Nummern**](https://app.callin.io/numbers) und wechselst zu [**BYOC**](https://app.callin.io/byoc), wenn du eine fortgeschrittenere Telefonie-Integration benötigst. ## Option 1: Behalte deine aktuelle Nummer und nutze Rufweiterleitung Das ist der schnellste und einfachste Weg, um zu starten. Bei dieser Option bleibt deine Hauptnummer bei deinem aktuellen Telefonanbieter. Sie wird weder übertragen noch migriert. Stattdessen verbindest du eine Nummer in Callin, weist sie deinem Agenten zu und aktivierst dann eine Rufweiterleitung von deiner üblichen Unternehmensnummer auf diese Agentennummer. Wenn jemand deine Hauptleitung anruft, wird der Anruf an die mit dem Agenten verbundene Nummer weitergeleitet und der Agent beantwortet ihn. ### So funktioniert es Zuerst brauchst du eine aktive Nummer in [**Nummern**](https://app.callin.io/numbers). Das ist die Nummer, die vom Agenten verwendet wird. Danach weist du diese Nummer dem richtigen Agenten zu. Sobald das erledigt ist, aktivierst du die Weiterleitung von deiner ursprünglichen Nummer auf die Agentennummer. Ab diesem Zeitpunkt können deine Kundinnen und Kunden weiterhin dieselbe Nummer anrufen, die sie bereits kennen, während der Agent den Anruf übernimmt. ### Was du wissen musst Die Rufweiterleitung wird nicht innerhalb von Callin aktiviert. Callin empfängt den Anruf auf der Nummer, die dem Agenten zugewiesen ist, aber die eigentliche Aktivierung der Weiterleitung hängt vom Kunden und seinem Telefonanbieter ab. Das bedeutet, dass der Benutzer sie über sein Telefon, über seine Telefonanlage oder bei seinem Telekommunikationsanbieter einrichten muss, je nachdem, wie seine aktuelle Leitung verwaltet wird. ### Wann diese Option sinnvoll ist Diese Option ist ideal, wenn du schnell vorankommen, deine öffentliche Unternehmensnummer unverändert lassen und einen technischeren Prozess oder eine Nummernmigration vermeiden möchtest. Sie ist auch eine sehr praktische Lösung, wenn du den Agenten bereits produktiv einsetzen möchtest, ohne deine bestehende Haupttelefonstruktur sofort zu verändern. ### Praxisbeispiel Eine Klinik nutzt seit Jahren dieselbe Festnetznummer. Diese Nummer steht auf der Website, in Google-Einträgen und in der gesamten Unternehmenskommunikation. Statt sie zu ändern, kauft die Klinik in Callin über [**Nummern**](https://app.callin.io/numbers) eine Nummer, weist sie ihrem Agenten zu und aktiviert über ihren Telefonanbieter die Weiterleitung von der Hauptleitung. Die Patientinnen und Patienten rufen weiterhin dieselbe Nummer an, aber der Agent antwortet. ### Vorteile * Es ist die schnellste Option zur Aktivierung. * Du kannst die Nummer behalten, die deine Kundinnen und Kunden bereits kennen. * Du musst deine Nummer nicht in eine andere Struktur überführen. * Sie ist leicht zu verstehen und leicht umzusetzen. ### Wichtige Hinweise Die Weiterleitung hängt von deinem Anbieter ab. Manche Anbieter erlauben sie über ein Kundenportal oder direkt am Telefon, andere verlangen dafür eine gesonderte Anfrage. Je nach Tarif können außerdem Kosten für weitergeleitete Anrufe anfallen. > **Wichtig:** Die Rufweiterleitung wird bei deinem Telefonanbieter oder in deinem internen Telefonsystem eingerichtet, nicht in Callin. ## Option 2: Portiere deine Nummer Die Portierung ermöglicht es dir, deine aktuelle Nummer zu behalten und zu beantragen, dass sie über den mit Callin kompatiblen Ablauf weiter genutzt wird, statt dauerhaft auf eine Weiterleitung angewiesen zu sein. Diese Option passt besonders gut, wenn du dieselbe kundenbekannte Nummer behalten möchtest, aber eine direktere Integration bevorzugst. ### Wo es beginnt Eine Portierungsanfrage wird in [**Nummern**](https://app.callin.io/numbers) gestartet. Innerhalb des Anfrageablaufs kannst du zwischen einer neuen Nummer und dem Start einer Portierungsanfrage wählen. Um mit dieser Option fortzufahren, wählst du Portierung, entscheidest dich für das Land, wählst den verfügbaren Nummerntyp und gibst die Nummer ein, die du portieren möchtest.Bildschirmaufnahme: Ansicht der Portierungsanfrage, in der der Benutzer seine Nummer eingibt und prüft, ob der Vorgang fortgesetzt werden kann.
### So funktioniert es Sobald die Nummer eingegeben wurde, führt die Plattform eine Portierungsprüfung durch, um zu überprüfen, ob diese Nummer im Prozess fortfahren kann. Diese Prüfung bestätigt, ob für diese Anfrage Abdeckung oder Verfügbarkeit besteht. Nicht alle Nummern können in allen Ländern portiert werden, und nicht alle Nummerntypen folgen denselben Regeln. ### Was passiert, wenn die Nummer nicht kompatibel ist Wenn die Nummer nicht fortfahren kann, zeigt die Plattform klar an, dass für diese Telefonnummer keine Abdeckung verfügbar ist. Das bedeutet nicht unbedingt, dass die Nummer ungültig ist. Es bedeutet, dass die Nummer in diesem Fall nicht im verfügbaren Portierungsablauf fortfahren kann. ### Was passiert, wenn die Nummer kompatibel ist Wenn die Nummer geeignet ist, kann die Anfrage fortgesetzt werden. Die nächsten Schritte können je nach Land, Nummerntyp und den Bedingungen des jeweiligen Falls unterschiedlich sein. ### Wann diese Option sinnvoll ist Die Portierung ist eine gute Wahl, wenn du deine aktuelle Nummer weiter nutzen möchtest, aber nicht dauerhaft von externer Weiterleitung abhängig sein willst. Sie ist auch der natürliche Weg, wenn deine Hauptnummer bereits Teil deiner Marke ist und du sie direkter in dein Betriebsmodell integrieren möchtest. ### Praxisbeispiel Eine Kanzlei nutzt seit Jahren dieselbe Unternehmensnummer. Die Mandanten kennen sie, und eine Änderung würde Reibung verursachen. In diesem Fall ermöglicht die Portierung der Kanzlei, diese Nummer als zentralen Kontaktpunkt zu behalten und gleichzeitig zu einer stärker integrierten Einrichtung überzugehen. ### Vorteile * Du kannst die Nummer behalten, die dein Unternehmen bereits nutzt. * Du vermeidest die dauerhafte Abhängigkeit von externer Weiterleitung. * Sie sorgt für eine natürlichere Kontinuität sowohl für Kundinnen und Kunden als auch für interne Teams. ### Wichtige Hinweise Die Portierung hängt von der Eignung ab. Die Verfügbarkeit kann je nach Land, Nummerntyp und der mit der Nummer verbundenen Abdeckung variieren. Deshalb beginnt der Prozess immer mit einer Prüfung in [**Nummern**](https://app.callin.io/numbers). > **Tipp:** Wenn deine Nummer die Verfügbarkeitsprüfung nicht besteht, kann die Rufweiterleitung trotzdem der schnellste Weg sein, um mit dem Agenten zu starten. ## Option 3: Verbinde deine Infrastruktur mit BYOC (SIP-Trunk) BYOC ermöglicht es dir, deinen eigenen Telefonanbieter mit Callin zu verbinden, damit der Agent auf deiner bestehenden Infrastruktur arbeiten kann. Das ist die fortgeschrittenste Option und wurde für Unternehmen entwickelt, die bereits Sprachkommunikation über IP, eine Telefonanlage, ein Telefonsystem oder einen eigenen SIP-Anbieter nutzen. ### Wo es eingerichtet wird Die gesamte Einrichtung benutzerdefinierter Anbieter wird im Bereich [**BYOC**](https://app.callin.io/byoc) verwaltet. Von dort aus kannst du Telnyx verbinden oder einen allgemeinen SIP-Trunk mit einem anderen Anbieter konfigurieren.Bildschirmaufnahme: BYOC-Bereich, in dem Benutzer ihren bestehenden Anbieter verbinden, Nummern importieren oder einen SIP-Trunk konfigurieren.
### Wann es sinnvoll ist BYOC ist die beste Wahl, wenn dein Unternehmen bereits über eine geschäftliche Telefonie-Struktur verfügt und keine Systeme doppeln oder seine Spracharchitektur neu aufbauen möchte. Es wird auch empfohlen, wenn du mehr Kontrolle darüber brauchst, wie Anrufe in die Plattform hinein- und aus ihr herausgehen, oder wenn dein Technikteam bereits mit SIP-Trunks und eigenen Zugangsdaten arbeitet. ### BYOC mit Telnyx Wenn du Telnyx bereits verwendest, kannst du es in [**BYOC**](https://app.callin.io/byoc) mit einem API-Schlüssel verbinden. Nachdem das Konto verbunden wurde, ruft die Plattform deine aktiven Nummern ab, fügt sie deinem Arbeitsbereich hinzu und bereitet die notwendige Verbindung für eingehende und ausgehende Anrufe vor. ### Wann du diese Option wählen solltest Das ist der beste Weg, wenn du bereits aktive Nummern in Telnyx hast und sie schneller und geführter mit Callin integrieren möchtest. ### Praxisbeispiel Ein Unternehmen nutzt Telnyx bereits für seine Geschäftstelefonie. Anstatt neue Nummern zu kaufen, verbindet es Telnyx über [**BYOC**](https://app.callin.io/byoc), importiert seine Nummern und arbeitet weiter mit dem Nummernbestand, der bereits produktiv eingesetzt wird. ### BYOC mit einem anderen SIP-Anbieter Wenn dein Anbieter nicht Telnyx ist, kannst du die allgemeine Einrichtung in [**BYOC**](https://app.callin.io/byoc) verwenden. Mit dieser Option kannst du einen SIP-Trunk eines anderen Anbieters verbinden und festlegen, wie eingehende und ausgehende Anrufe verarbeitet werden. ### Was in dieser Einrichtung festgelegt wird Zuerst legst du die grundlegenden Trunk-Details und die Nummer fest, die du verwenden möchtest. Danach konfigurierst du die eingehende Seite, die bestimmt, wohin eingehende Anrufe zugestellt werden. Anschließend konfigurierst du die ausgehende Seite, die festlegt, welcher Server und welche Zugangsdaten für ausgehende Anrufe verwendet werden. ### Einfach erklärt Die eingehende Seite bestimmt, wo dein System Anrufe empfängt.\ Die ausgehende Seite bestimmt, wie Anrufe die Plattform verlassen. Diese Trennung ist in geschäftlichen Telefonie-Umgebungen üblich und gibt dir mehr operative Kontrolle. ### Wann du diese Option nutzen solltest Das ist der beste Weg, wenn dein Unternehmen bereits mit einem anderen SIP-Anbieter arbeitet, wenn du deine eigene Telefonanlage hast oder wenn du eine bestehende Unternehmens-Telefonarchitektur beibehalten musst. ### Praxisbeispiel Ein internationales Unternehmen arbeitet mit einem SIP-Anbieter, der bereits seine Nummern, sein Routing und seine internen Regeln verwaltet. Statt seine gesamte Telefonumgebung neu aufzubauen, verbindet es diesen Trunk über [**BYOC**](https://app.callin.io/byoc) und ermöglicht dem Agenten, innerhalb dieser bestehenden Struktur zu arbeiten. > **Wichtig:** BYOC wird für Unternehmen empfohlen, die bereits ein Telefonieteam, einen SIP-Anbieter oder eine bestehende Telefonanlagen-Konfiguration haben. ## Weise die Nummer dem Agenten zu Dass sich die Nummer in deinem Arbeitsbereich befindet, ist nicht der letzte Schritt. Damit der Agent sie verwenden kann, muss die Nummer dem richtigen Agenten zugewiesen werden. Diese Zuweisung ist Teil der tatsächlichen Aktivierung der Leitung. Wenn die Nummer in deinem Konto vorhanden ist, aber nicht zugewiesen wurde, ist sie noch nicht bereit, als aktive Telefonleitung des Agenten zu funktionieren. ### Wo es verwaltet wird Die Nummer selbst wird in [**Nummern**](https://app.callin.io/numbers) verwaltet, aber die Zuweisung gehört ebenfalls zur betrieblichen Einrichtung des Agenten. ### Warum es wichtig ist Eine Nummer kann korrekt gekauft, verbunden oder importiert worden sein und sich trotzdem nicht wie erwartet verhalten, wenn sie nicht mit dem richtigen Agenten verknüpft ist. ### Praxisbeispiel Wenn dein Unternehmen einen Agenten für den Support und einen weiteren für den Vertrieb hat, musst du sicherstellen, dass jede Nummer dem richtigen Agenten zugewiesen ist. So vermeidest du, dass eine für den Vertrieb gedachte Leitung vom Support-Ablauf beantwortet wird oder umgekehrt. > **Häufiger Fehler:** Das Importieren oder Kaufen einer Nummer reicht allein nicht aus. Die Nummer muss weiterhin dem richtigen Agenten zugewiesen werden. ## Welche Option solltest du wählen Wenn du eine einfache Empfehlung möchtest: * Wenn du schnell starten möchtest, ohne deine Hauptnummer zu ändern, nutze Rufweiterleitung. * Wenn du diese Nummer in einem stärker integrierten Betriebsmodell behalten möchtest, nutze die Portierung, wenn sie verfügbar ist. * Wenn dein Unternehmen bereits über eine eigene Telefoninfrastruktur verfügt, nutze BYOC. Die beste Option ist diejenige, die zu deinem aktuellen Betrieb, deinem Anbieter und dem Maß an Kontrolle passt, das du behalten möchtest. # Come collegare il tuo numero a Callin Source: https://support.callin.io/Create-AI-Agent/ConnectNumberItalian Scopri i tre modi per collegare il tuo numero aziendale esistente a un agente di Callin: inoltro di chiamata, portabilità o BYOC. ## Collega il tuo numero esistente a un agente Se la tua azienda ha già un numero di telefono e vuoi che un agente IA risponda alle chiamate su quella linea, non devi ricostruire tutta la tua configurazione telefonica per iniziare. In Callin, puoi farlo in tre modi diversi a seconda del livello di integrazione di cui hai bisogno e dell’infrastruttura telefonica che hai già. Puoi collegare il tuo numero esistente tramite: * **Inoltro di chiamata**, se vuoi mantenere la tua linea attuale e reindirizzare le chiamate al numero dell’agente. * **Portabilità**, se vuoi mantenere lo stesso numero e richiederne la migrazione tramite il flusso compatibile con Callin. * **BYOC (tronco SIP)**, se lavori già con un operatore SIP, un centralino o un sistema telefonico e vuoi collegare quell’infrastruttura alla piattaforma. L’opzione migliore dipende dal fatto che tu voglia rapidità, continuità con il tuo numero attuale o una configurazione tecnica più avanzata. ## Dove viene gestita ogni opzione Tutto ciò che riguarda l’acquisto di numeri, l’avvio di una richiesta di portabilità e la gestione dei numeri viene gestito dalla sezione [**Numeri**](https://app.callin.io/numbers). Il collegamento del tuo operatore, dei tronchi SIP o dei fornitori esterni viene gestito dalla sezione [**BYOC**](https://app.callin.io/byoc). Se il tuo obiettivo è usare un numero esistente con un agente, di solito inizierai da [**Numeri**](https://app.callin.io/numbers) e passerai a [**BYOC**](https://app.callin.io/byoc) se hai bisogno di un’integrazione telefonica più avanzata. ## Opzione 1: Mantieni il tuo numero attuale e usa l’inoltro di chiamata Questo è il modo più rapido e semplice per iniziare. Con questa opzione, il tuo numero principale resta con il tuo attuale operatore telefonico. Non viene trasferito e non viene migrato. Al suo posto, colleghi un numero in Callin, lo assegni al tuo agente e poi attivi l’inoltro di chiamata dal tuo normale numero aziendale al numero dell’agente. Quando qualcuno chiama la tua linea principale, la chiamata viene reindirizzata al numero collegato all’agente e l’agente risponde. ### Come funziona Per prima cosa, hai bisogno di un numero attivo in [**Numeri**](https://app.callin.io/numbers). Sarà il numero usato dall’agente. Poi assegni quel numero all’agente corretto. Una volta fatto, attivi l’inoltro dal tuo numero originale al numero dell’agente. Da quel momento in poi, i tuoi clienti possono continuare a chiamare lo stesso numero che già conoscono, mentre l’agente gestisce la chiamata. ### Cosa devi sapere L’inoltro di chiamata non viene attivato all’interno di Callin. Callin riceve la chiamata sul numero assegnato all’agente, ma l’attivazione dell’inoltro dipende dal cliente e dal suo operatore telefonico. Questo significa che l’utente deve configurarlo dal proprio telefono, tramite il proprio centralino o con il proprio fornitore di telecomunicazioni, a seconda di come viene gestita la linea attuale. ### Quando questa opzione ha senso Questa opzione è ideale se vuoi muoverti rapidamente, mantenere invariato il tuo numero aziendale pubblico ed evitare un processo più tecnico o una migrazione del numero. È anche una soluzione molto pratica se vuoi iniziare a usare l’agente in produzione senza cambiare ancora la tua struttura telefonica principale. ### Esempio pratico Una clinica usa lo stesso numero fisso da anni. Quel numero compare sul suo sito, nelle schede Google e in tutte le sue comunicazioni aziendali. Invece di cambiarlo, la clinica acquista un numero in Callin tramite [**Numeri**](https://app.callin.io/numbers), lo assegna al proprio agente e attiva l’inoltro dalla linea principale tramite il proprio operatore telefonico. I pazienti continuano a chiamare lo stesso numero, ma a rispondere è l’agente. ### Vantaggi * È l’opzione più rapida da attivare. * Ti permette di mantenere il numero che i tuoi clienti già conoscono. * Non richiede di spostare il tuo numero in una configurazione diversa. * È facile da capire e facile da implementare. ### Considerazioni importanti L’inoltro dipende dal tuo operatore. Alcuni fornitori lo consentono da un portale cliente o direttamente dal telefono, mentre altri richiedono una richiesta specifica. A seconda del tuo piano, potrebbero esserci anche costi associati alle chiamate inoltrate. > **Importante:** L’inoltro di chiamata si configura con il tuo operatore telefonico o con il tuo sistema telefonico interno, non dentro Callin. ## Opzione 2: Porta il tuo numero La portabilità ti permette di mantenere il tuo numero attuale e richiedere che continui a funzionare tramite il flusso compatibile con Callin, invece di dipendere da un inoltro permanente. Questa opzione è molto adatta quando vuoi mantenere lo stesso numero visibile ai clienti ma preferisci un’integrazione più diretta. ### Da dove inizia Una richiesta di portabilità inizia da [**Numeri**](https://app.callin.io/numbers). All’interno del flusso di richiesta, puoi scegliere tra richiedere un nuovo numero o avviare una richiesta di portabilità. Per continuare con questa opzione, selezioni la portabilità, scegli il paese, selezioni il tipo di numero disponibile e inserisci il numero che vuoi portare.Schermata: schermata della richiesta di portabilità, dove l’utente inserisce il proprio numero e verifica se può continuare.
### Come funziona Una volta inserito il numero, la piattaforma esegue un controllo di portabilità per verificare se quel numero può continuare nel processo. Questa verifica conferma se esistono copertura o disponibilità per quella richiesta. Non tutti i numeri possono essere portati in tutti i paesi e non tutti i tipi di numero seguono le stesse regole. ### Cosa succede se il numero non è compatibile Se il numero non può continuare, la piattaforma indicherà chiaramente che non è disponibile copertura per quel numero di telefono. Questo non significa necessariamente che il numero non sia valido. Significa che, in quel caso, il numero non può continuare nel flusso di portabilità disponibile. ### Cosa succede se il numero è compatibile Se il numero è idoneo, la richiesta può continuare. I passaggi successivi possono variare in base al paese, al tipo di numero e alle condizioni applicabili in quel caso. ### Quando questa opzione ha senso La portabilità è una buona scelta quando vuoi continuare a usare il tuo numero attuale ma non vuoi dipendere dall’inoltro esterno come soluzione a lungo termine. È anche il percorso naturale quando il tuo numero principale fa già parte del tuo marchio e vuoi integrarlo in modo più diretto nel tuo modello operativo. ### Esempio pratico Uno studio professionale usa lo stesso numero aziendale da anni. I clienti lo conoscono e cambiarlo creerebbe attrito. In questo caso, la portabilità permette allo studio di mantenere quel numero come principale punto di contatto mentre passa a una configurazione più integrata. ### Vantaggi * Ti permette di mantenere il numero che la tua azienda già usa. * Evita di dipendere dall’inoltro esterno come soluzione permanente. * Offre una continuità più naturale sia per i clienti sia per i team interni. ### Considerazioni importanti La portabilità dipende dall’idoneità. La disponibilità può variare in base al paese, al tipo di numero e alla copertura associata al numero. Per questo il processo inizia sempre con un controllo da [**Numeri**](https://app.callin.io/numbers). > **Suggerimento:** Se il tuo numero non supera il controllo di disponibilità, l’inoltro di chiamata può comunque essere il modo più rapido per iniziare a usare l’agente. ## Opzione 3: Collega la tua infrastruttura con BYOC (tronco SIP) BYOC ti permette di collegare il tuo fornitore di telefonia a Callin in modo che l’agente possa operare sopra la tua infrastruttura esistente. È l’opzione più avanzata ed è pensata per le aziende che già usano voce su IP, un centralino, un sistema telefonico o un proprio fornitore SIP. ### Dove si configura Tutta la configurazione dei fornitori personalizzati viene gestita dalla sezione [**BYOC**](https://app.callin.io/byoc). Da questa sezione, puoi collegare Telnyx o configurare un tronco SIP generico con un altro fornitore.Schermata: sezione BYOC, dove gli utenti collegano il proprio operatore esistente, importano numeri o configurano un tronco SIP.
### Quando ha senso BYOC è la scelta migliore quando la tua azienda ha già una configurazione telefonica aziendale e non vuole duplicare i sistemi o ricostruire la propria architettura vocale. È consigliato anche se hai bisogno di maggiore controllo su come le chiamate entrano ed escono dalla piattaforma, oppure se il tuo team tecnico lavora già con tronchi SIP e credenziali proprie. ### BYOC con Telnyx Se usi già Telnyx, puoi collegarlo da [**BYOC**](https://app.callin.io/byoc) usando una chiave API. Dopo aver collegato l’account, la piattaforma recupera i tuoi numeri attivi, li aggiunge al tuo spazio di lavoro e prepara la connessione necessaria per le chiamate in entrata e in uscita. ### Quando scegliere questa opzione Questo è il percorso migliore se hai già numeri attivi in Telnyx e vuoi integrarli con Callin in modo più guidato e veloce. ### Esempio pratico Un’azienda usa già Telnyx per la propria telefonia aziendale. Invece di acquistare nuovi numeri, collega Telnyx da [**BYOC**](https://app.callin.io/byoc), importa i suoi numeri e continua a lavorare con l’inventario di numeri che ha già in produzione. ### BYOC con un altro fornitore SIP Se il tuo fornitore non è Telnyx, puoi usare la configurazione generica disponibile in [**BYOC**](https://app.callin.io/byoc). Questa opzione ti permette di collegare un tronco SIP di un altro fornitore e definire come verranno gestite le chiamate in entrata e in uscita. ### Cosa viene definito in questa configurazione Per prima cosa definisci i dettagli di base del tronco e il numero che vuoi usare. Poi configuri la parte in entrata, che determina dove devono essere consegnate le chiamate in arrivo. Infine configuri la parte in uscita, che definisce quale server e quali credenziali verranno usati per le chiamate in uscita. ### In termini semplici La parte in entrata determina dove il tuo sistema riceve le chiamate.\ La parte in uscita determina come le chiamate lasciano la piattaforma. Questa separazione è comune negli ambienti di telefonia aziendale e ti offre maggiore controllo operativo. ### Quando usare questa opzione Questo è il percorso migliore quando la tua azienda lavora già con un altro fornitore SIP, quando hai il tuo centralino o quando devi mantenere un’architettura telefonica aziendale esistente. ### Esempio pratico Un’azienda internazionale lavora con un fornitore SIP che già gestisce i suoi numeri, l’instradamento e le regole interne. Invece di ricostruire tutto il proprio ambiente telefonico, collega quel tronco da [**BYOC**](https://app.callin.io/byoc) e permette all’agente di operare all’interno di quella configurazione esistente. > **Importante:** BYOC è consigliato per le aziende che hanno già un team di telefonia, un fornitore SIP o una configurazione di centralino esistente. ## Assegna il numero all’agente Avere il numero nel tuo spazio di lavoro non è l’ultimo passaggio. Perché l’agente possa usarlo, il numero deve essere assegnato all’agente corretto. Questa assegnazione fa parte dell’attivazione effettiva della linea. Se il numero esiste nel tuo account ma non è stato assegnato, non è ancora pronto per funzionare come linea telefonica attiva dell’agente. ### Dove viene gestito Il numero in sé viene gestito da [**Numeri**](https://app.callin.io/numbers), ma l’assegnazione fa anche parte della configurazione operativa dell’agente. ### Perché è importante Un numero può essere stato acquistato, collegato o importato correttamente e comunque non comportarsi come previsto se non è collegato all’agente giusto. ### Esempio pratico Se la tua azienda ha un agente per l’assistenza e un altro per le vendite, devi assicurarti che ogni numero sia assegnato a quello corretto. In questo modo eviti una situazione in cui una linea pensata per le vendite venga gestita dal flusso di assistenza, o viceversa. > **Errore comune:** Importare o acquistare un numero non basta da solo. Il numero deve comunque essere assegnato all’agente corretto. ## Quale opzione dovresti scegliere Se vuoi una raccomandazione semplice: * Se vuoi iniziare rapidamente senza cambiare il tuo numero principale, usa l’inoltro di chiamata. * Se vuoi mantenere quel numero all’interno di un modello operativo più integrato, usa la portabilità quando è disponibile. * Se la tua azienda ha già una propria infrastruttura telefonica, usa BYOC. L’opzione migliore è quella che si adatta alle tue operazioni attuali, al tuo fornitore e al livello di controllo che vuoi mantenere. # Cómo conectar tu número a Callin Source: https://support.callin.io/Create-AI-Agent/ConnectNumberSpanish Conoce las tres formas de conectar tu número de empresa existente a un agente de Callin: desvío de llamadas, portabilidad o BYOC. ## Conecta tu número existente a un agente Si tu empresa ya tiene un número de teléfono y quieres que un agente de IA responda las llamadas en esa línea, no necesitas reconstruir toda tu configuración telefónica para empezar. En Callin, puedes hacerlo de tres formas diferentes según el nivel de integración que necesites y la infraestructura telefónica que ya tengas. Puedes conectar tu número existente mediante: * **Desvío de llamadas**, si quieres mantener tu línea actual y redirigir las llamadas al número del agente. * **Portabilidad**, si quieres mantener el mismo número y solicitar su migración mediante el flujo compatible con Callin. * **BYOC (troncal SIP)**, si ya trabajas con un operador SIP, una centralita o un sistema telefónico y quieres conectar esa infraestructura a la plataforma. La mejor opción depende de si buscas rapidez, continuidad con tu número actual o una configuración técnica más avanzada. ## Dónde se gestiona cada opción Todo lo relacionado con comprar números, iniciar una solicitud de portabilidad y gestionar números se maneja desde la sección [**Números**](https://app.callin.io/numbers). La conexión de tu propio operador, troncales SIP o proveedores externos se gestiona desde la sección [**BYOC**](https://app.callin.io/byoc). Si tu objetivo es usar un número existente con un agente, normalmente empezarás en [**Números**](https://app.callin.io/numbers) y pasarás a [**BYOC**](https://app.callin.io/byoc) si necesitas una integración telefónica más avanzada. ## Opción 1: Mantén tu número actual y usa desvío de llamadas Esta es la forma más rápida y sencilla de empezar. Con esta opción, tu número principal permanece con tu proveedor telefónico actual. No se transfiere ni se migra. En su lugar, conectas un número en Callin, lo asignas a tu agente y luego activas el desvío de llamadas desde tu número habitual de empresa hacia ese número del agente. Cuando alguien llama a tu línea principal, la llamada se redirige al número conectado al agente y el agente la responde. ### Cómo funciona Primero, necesitas un número activo en [**Números**](https://app.callin.io/numbers). Ese será el número que usará el agente. Después asignas ese número al agente correcto. Una vez hecho esto, activas el desvío desde tu número original al número del agente. A partir de ese momento, tus clientes pueden seguir llamando al mismo número que ya conocen, mientras el agente gestiona la llamada. ### Lo que debes saber El desvío de llamadas no se activa dentro de Callin. Callin recibe la llamada en el número asignado al agente, pero la activación del desvío depende del cliente y de su operador telefónico. Esto significa que el usuario debe configurarlo desde su teléfono, a través de su centralita o con su proveedor de telecomunicaciones, según cómo esté gestionada su línea actual. ### Cuándo tiene sentido esta opción Esta opción es ideal si quieres avanzar rápido, mantener sin cambios tu número público de empresa y evitar un proceso más técnico o una migración del número. También es una solución muy práctica si quieres empezar a usar el agente en producción sin cambiar todavía tu estructura telefónica principal. ### Ejemplo práctico Una clínica ha usado el mismo número fijo durante años. Ese número aparece en su web, en Google y en todas sus comunicaciones comerciales. En lugar de cambiarlo, la clínica compra un número en Callin desde [**Números**](https://app.callin.io/numbers), lo asigna a su agente y activa el desvío desde la línea principal a través de su operador telefónico. Los pacientes siguen llamando al mismo número, pero es el agente quien responde. ### Ventajas * Es la opción más rápida de activar. * Te permite conservar el número que tus clientes ya conocen. * No requiere mover tu número a una configuración distinta. * Es fácil de entender y fácil de implementar. ### Consideraciones importantes El desvío depende de tu operador. Algunos proveedores lo permiten desde un portal de cliente o directamente desde el teléfono, mientras que otros requieren una solicitud específica. Según tu plan, también puede haber cargos asociados a las llamadas desviadas. > **Importante:** El desvío de llamadas se configura con tu operador telefónico o con tu sistema telefónico interno, no dentro de Callin. ## Opción 2: Porta tu número La portabilidad te permite mantener tu número actual y solicitar que siga funcionando a través del flujo compatible con Callin, en lugar de depender de un desvío permanente. Esta opción encaja muy bien cuando quieres conservar el mismo número de cara al cliente pero prefieres una integración más directa. ### Dónde empieza Una solicitud de portabilidad se inicia desde [**Números**](https://app.callin.io/numbers). Dentro del flujo de solicitud, puedes elegir entre pedir un número nuevo o iniciar una solicitud de portabilidad. Para continuar por esta opción, seleccionas portabilidad, eliges el país, seleccionas el tipo de número disponible e introduces el número que quieres portar.Captura: pantalla de la solicitud de portabilidad, donde el usuario introduce su número y comprueba si puede continuar.
### Cómo funciona Una vez introducido el número, la plataforma realiza una comprobación de portabilidad para verificar si ese número puede continuar en el proceso. Esta validación confirma si existe cobertura o disponibilidad para esa solicitud. No todos los números se pueden portar en todos los países, y no todos los tipos de número siguen las mismas reglas. ### Qué ocurre si el número no es compatible Si el número no puede continuar, la plataforma indicará claramente que no hay cobertura disponible para ese número de teléfono. Eso no significa necesariamente que el número no sea válido. Significa que, en ese caso, el número no puede continuar por el flujo de portabilidad disponible. ### Qué ocurre si el número es compatible Si el número es apto, la solicitud puede continuar. Los siguientes pasos pueden variar según el país, el tipo de número y las condiciones que apliquen en ese caso. ### Cuándo tiene sentido esta opción La portabilidad es una buena elección cuando quieres seguir usando tu número actual pero no quieres depender del desvío externo como solución a largo plazo. También es el camino natural cuando tu número principal ya forma parte de tu marca y quieres integrarlo de forma más directa en tu modelo operativo. ### Ejemplo práctico Un despacho profesional ha usado el mismo número de empresa durante años. Sus clientes lo conocen y cambiarlo generaría fricción. En ese caso, la portabilidad permite que el despacho conserve ese número como punto principal de contacto mientras avanza hacia una configuración más integrada. ### Ventajas * Te permite conservar el número que tu empresa ya utiliza. * Evita depender del desvío externo como solución permanente. * Ofrece una continuidad más natural tanto para clientes como para equipos internos. ### Consideraciones importantes La portabilidad depende de la elegibilidad. La disponibilidad puede variar según el país, el tipo de número y la cobertura asociada al número. Por eso el proceso siempre empieza con una comprobación desde [**Números**](https://app.callin.io/numbers). > **Consejo:** Si tu número no supera la comprobación de disponibilidad, el desvío de llamadas puede seguir siendo la forma más rápida de empezar a usar el agente. ## Opción 3: Conecta tu infraestructura con BYOC (troncal SIP) BYOC te permite conectar tu propio proveedor de telefonía a Callin para que el agente funcione sobre tu infraestructura existente. Es la opción más avanzada y está pensada para empresas que ya usan voz sobre IP, una centralita, un sistema telefónico o su propio proveedor SIP. ### Dónde se configura Toda la configuración de operadores personalizados se gestiona desde la sección [**BYOC**](https://app.callin.io/byoc). Desde esta sección, puedes conectar Telnyx o configurar una troncal SIP genérica con otro proveedor.Captura: sección BYOC, donde los usuarios conectan su operador existente, importan números o configuran una troncal SIP.
### Cuándo tiene sentido BYOC es la mejor opción cuando tu empresa ya tiene una configuración telefónica empresarial y no quiere duplicar sistemas ni reconstruir su arquitectura de voz. También se recomienda si necesitas más control sobre cómo entran y salen las llamadas de la plataforma, o si tu equipo técnico ya trabaja con troncales SIP y sus propias credenciales. ### BYOC con Telnyx Si ya usas Telnyx, puedes conectarlo desde [**BYOC**](https://app.callin.io/byoc) usando una clave de API. Después de conectar la cuenta, la plataforma recupera tus números activos, los añade a tu espacio de trabajo y prepara la conexión necesaria para las llamadas entrantes y salientes. ### Cuándo elegir esta opción Este es el mejor camino si ya tienes números activos en Telnyx y quieres integrarlos con Callin de una manera más guiada y rápida. ### Ejemplo práctico Una empresa ya usa Telnyx para su telefonía comercial. En lugar de comprar números nuevos, conecta Telnyx desde [**BYOC**](https://app.callin.io/byoc), importa sus números y sigue trabajando con el inventario de números que ya tiene en producción. ### BYOC con otro proveedor SIP Si tu proveedor no es Telnyx, puedes usar la configuración genérica disponible en [**BYOC**](https://app.callin.io/byoc). Esta opción te permite conectar una troncal SIP de otro proveedor y definir cómo se gestionarán las llamadas entrantes y salientes. ### Qué se define en esta configuración Primero defines los datos básicos de la troncal y el número que quieres usar. Después configuras la parte de entrada, que determina dónde deben entregarse las llamadas entrantes. Por último, configuras la parte de salida, que define qué servidor y credenciales se usarán para las llamadas salientes. ### En términos simples La parte de entrada determina dónde recibe llamadas tu sistema.\ La parte de salida determina cómo salen las llamadas de la plataforma. Esta separación es habitual en entornos de telefonía empresarial y te da más control operativo. ### Cuándo usar esta opción Este es el mejor camino cuando tu empresa ya trabaja con un proveedor SIP distinto, cuando tienes tu propia centralita o cuando necesitas mantener una arquitectura telefónica corporativa ya existente. ### Ejemplo práctico Una empresa internacional trabaja con un proveedor SIP que ya gestiona sus números, sus rutas y sus reglas internas. En lugar de reconstruir todo su entorno telefónico, conecta esa troncal desde [**BYOC**](https://app.callin.io/byoc) y permite que el agente funcione dentro de esa configuración existente. > **Importante:** BYOC se recomienda para empresas que ya tienen un equipo de telefonía, un proveedor SIP o una configuración de centralita existente. ## Asigna el número al agente Tener el número en tu espacio de trabajo no es el último paso. Para que el agente lo use, el número debe estar asignado al agente correcto. Esta asignación forma parte de la activación real de la línea. Si el número existe en tu cuenta pero no ha sido asignado, todavía no está listo para funcionar como la línea telefónica activa del agente. ### Dónde se gestiona El número en sí se gestiona desde [**Números**](https://app.callin.io/numbers), pero la asignación también forma parte de la configuración operativa del agente. ### Por qué importa Un número puede estar correctamente comprado, conectado o importado y aun así no comportarse como esperas si no está vinculado al agente correcto. ### Ejemplo práctico Si tu empresa tiene un agente para soporte y otro para ventas, debes asegurarte de que cada número esté asignado al correcto. Así evitas una situación en la que una línea pensada para ventas sea respondida por el flujo de soporte, o al revés. > **Error común:** Importar o comprar un número no es suficiente por sí solo. El número todavía debe asignarse al agente correcto. ## Qué opción deberías elegir Si quieres una recomendación simple: * Si quieres empezar rápido sin cambiar tu número principal, usa desvío de llamadas. * Si quieres mantener ese número dentro de un modelo operativo más integrado, usa portabilidad cuando esté disponible. * Si tu empresa ya tiene su propia infraestructura telefónica, usa BYOC. La mejor opción es la que encaja con tu operativa actual, tu proveedor y el nivel de control que quieres mantener. # Contacts Source: https://support.callin.io/Create-AI-Agent/Contact Add contacts manually or from a CSV, manage your list, and start campaigns from the Contacts page. ## Overview The **Contacts** page is where you manage who you’ll call. From here you can: * **Add contacts manually** (one or many) * **Upload a CSV** to import a larger list * **Search and filter** your contact list * **Export** your contacts to CSV * **Start campaigns** using selected contacts * **Delete selected** contacts (permanent) To open Contacts directly: [Click here to go to Contacts](https://app.callin.io/contacts)Screenshot: The Contacts page where you can add/import contacts and manage your list.
## Add contacts manually Manual entry is best when you’re adding a few contacts quickly (or pasting from a spreadsheet). ### Steps 1. Click **Add Contact**. 2. Fill in the fields you need: * **Name** (optional) * **Phone Number** (required) * **Email** (optional) 3. Add more people by adding more rows (if available in your modal). > **Important:** **Phone Number is required** for every contact. ### Editing tips (like a spreadsheet) In the add-contacts grid you can usually: * Click and drag to select multiple cells * Copy and paste values into the grid * Double-click a cell to edit * Press **Enter** to add a new row * Press **Esc** to clear selection > **Tip:** If your contacts are already in Google Sheets/Excel, copy the cells and paste them directly into the grid. ### Optional columns You may see an **Add Column** button in the modal. This lets you include extra fields if your workspace supports them. > **Important:** Available columns can vary by account or plan. ## Import contacts from a CSV CSV import is best for larger lists. ### Upload requirements * **File type:** CSV only * **Max size:** 10MB * You can upload by selecting a file or dragging and dropping it. > **Common mistake:** Uploading an .xlsx file. Export it as **CSV** first. ### Upload a CSV 1. Click **Upload CSV**. 2. (Optional) Click **Download Template** to start from the recommended format. 3. Upload your CSV by clicking **Select File** or dragging the file into the upload area.Screenshot: CSV upload modal, including the CSV-only requirement and the 10MB limit.
### Map your columns After upload, you’ll map your CSV headers to the fields Callin will import. * **Phone** (required) * **Name** (optional) * **Email** (optional) > **Important:** If **Phone** is not mapped, the import can’t continue. ### Validation rules (applies to manual + CSV) * Phone numbers must include a **country code** (example: **+1234567890**) * Phone numbers must be **7–15 digits** (excluding country code) * Phone numbers are **required** for all contacts * Email addresses must be **valid** if provided * Fields with validation errors are highlighted with a **red border** * Empty fields are highlighted with a **red border** > **Tip:** If your CSV has phone numbers without country codes, add the country code before importing to avoid validation errors. ## Manage your contact list ### Search and filters * Use **Search contacts…** to find people by name, phone, or email. * Click **Filters** to narrow down your list. > **Important:** Filter options can vary by account or plan. ### View and edit In the **Actions** column, you can typically: * **View** contact details * **Edit** the contact ### Export to CSV Click **Export to CSV** to download your current contacts list. ## Start a campaign from Contacts 1. Select one or more contacts using the checkboxes. 2. Click **Start Campaign**. 3. Enter a **campaign name** and **select an agent**. 4. (Optional) Enable **Follow-up Calls**. When enabled, follow-ups are scheduled for each contact after an **unanswered** or **busy** call: * After **2 hours** * After **1 day** * After **3 days** > **Tip:** If you’re testing, start with a small selection (5–10 contacts) to confirm your agent and script behave as expected. ## Delete selected contacts (permanent) 1. Select the contacts you want to remove. 2. Click **Delete Selected**. 3. Confirm the deletion (you may need to type **DELETE**). > **Important:** This is a **permanent action** and cannot be undone. # Kontakte Source: https://support.callin.io/Create-AI-Agent/Contact-copied-1 Fügen Sie Kontakte manuell oder per CSV hinzu, verwalten Sie Ihre Liste und starten Sie Kampagnen von der Seite Contacts. ## Überblick Die Seite **Contacts** ist der Ort, an dem Sie verwalten, wen Sie anrufen. Von hier aus können Sie: * **Kontakte manuell hinzufügen** (einen oder mehrere) * **Eine CSV hochladen**, um eine größere Liste zu importieren * **Ihre Kontaktliste durchsuchen und filtern** * **Kontakte als CSV exportieren** * **Kampagnen starten** mit ausgewählten Kontakten * **Ausgewählte löschen** (dauerhafte Aktion) Um Contacts direkt zu öffnen: [Klicken Sie hier, um zu Contacts zu gehen](https://app.callin.io/contacts)Screenshot: Die Contacts-Seite, auf der Sie Kontakte hinzufügen/importieren und Ihre Liste verwalten.
## Kontakte manuell hinzufügen Die manuelle Eingabe ist ideal, wenn Sie schnell nur wenige Kontakte hinzufügen (oder Daten aus einer Tabelle einfügen). ### Schritte 1. Klicken Sie auf **Add Contact**. 2. Füllen Sie die benötigten Felder aus: * **Name** (optional) * **Phone Number** (erforderlich) * **Email** (optional) 3. Fügen Sie weitere Personen hinzu, indem Sie weitere Zeilen hinzufügen (falls in Ihrem Dialog verfügbar). > **Wichtig:** **Phone Number ist erforderlich** für jeden Kontakt. ### Bearbeitungstipps (wie in einer Tabelle) Im Hinzufügen-Grid können Sie normalerweise: * Klicken und ziehen, um mehrere Zellen zu markieren * Werte kopieren und in das Grid einfügen * Eine Zelle doppelt anklicken, um sie zu bearbeiten * **Enter** drücken, um eine neue Zeile hinzuzufügen * **Esc** drücken, um die Auswahl zu löschen > **Tipp:** Wenn Ihre Kontakte bereits in Google Sheets/Excel sind, kopieren Sie die Zellen und fügen Sie sie direkt in das Grid ein. ### Optionale Spalten Möglicherweise sehen Sie im Dialog den Button **Add Column**. Damit können Sie zusätzliche Felder hinzufügen, wenn Ihr Workspace diese unterstützt. > **Wichtig:** Verfügbare Spalten können je nach Account oder Plan variieren. ## Kontakte per CSV importieren Der CSV-Import ist am besten für größere Listen geeignet. ### Upload-Anforderungen * **Dateityp:** nur CSV * **Maximale Größe:** 10MB * Sie können per Dateiauswahl oder Drag-and-drop hochladen. > **Häufiger Fehler:** Eine .xlsx-Datei hochladen. Exportieren Sie sie zuerst als **CSV**. ### Eine CSV hochladen 1. Klicken Sie auf **Upload CSV**. 2. (Optional) Klicken Sie auf **Download Template**, um mit dem empfohlenen Format zu starten. 3. Laden Sie Ihre CSV hoch, indem Sie auf **Select File** klicken oder die Datei in den Upload-Bereich ziehen.Screenshot: CSV-Upload-Dialog mit der Vorgabe CSV only und dem 10MB-Limit.
### Spalten zuordnen Nach dem Upload ordnen Sie die CSV-Spaltenüberschriften den Feldern zu, die Callin importiert. * **Phone** (erforderlich) * **Name** (optional) * **Email** (optional) > **Wichtig:** Wenn **Phone** nicht zugeordnet ist, kann der Import nicht fortfahren. ### Validierungsregeln (gelten für manuell + CSV) * Telefonnummern müssen einen **Ländercode** enthalten (Beispiel: **+1234567890**) * Telefonnummern müssen **7–15 Ziffern** haben (ohne Ländercode) * Telefonnummern sind **für alle Kontakte erforderlich** * Emails müssen **gültig** sein, wenn angegeben * Felder mit Validierungsfehlern werden mit einem **roten Rahmen** hervorgehoben * Leere Felder werden mit einem **roten Rahmen** hervorgehoben > **Tipp:** Wenn Ihre CSV Telefonnummern ohne Ländercode enthält, fügen Sie den Ländercode vor dem Import hinzu, um Validierungsfehler zu vermeiden. ## Kontaktliste verwalten ### Suche und Filter * Verwenden Sie **Search contacts…**, um nach Name, Nummer oder Email zu suchen. * Klicken Sie auf **Filters**, um Ihre Liste einzugrenzen. > **Wichtig:** Filteroptionen können je nach Account oder Plan variieren. ### Anzeigen und bearbeiten In der Spalte **Actions** können Sie typischerweise: * Kontaktdetails **anzeigen** * Den Kontakt **bearbeiten** ### Als CSV exportieren Klicken Sie auf **Export to CSV**, um Ihre aktuelle Kontaktliste herunterzuladen. ## Eine Kampagne von Contacts starten 1. Wählen Sie einen oder mehrere Kontakte über die Checkboxen aus. 2. Klicken Sie auf **Start Campaign**. 3. Geben Sie einen **campaign name** ein und **select an agent**. 4. (Optional) Aktivieren Sie **Follow-up Calls**. Wenn aktiviert, werden Follow-ups für jeden Kontakt nach einem **unanswered** oder **busy** Call geplant: * Nach **2 hours** * Nach **1 day** * Nach **3 days** > **Tipp:** Wenn Sie testen, starten Sie mit einer kleinen Auswahl (5–10 Kontakte), um sicherzustellen, dass Agent und Skript wie erwartet funktionieren. ## Ausgewählte Kontakte löschen (permanent) 1. Wählen Sie die Kontakte aus, die Sie entfernen möchten. 2. Klicken Sie auf **Delete Selected**. 3. Bestätigen Sie das Löschen (möglicherweise müssen Sie **DELETE** eingeben). > **Wichtig:** Das ist eine **dauerhafte** Aktion und kann nicht rückgängig gemacht werden. # Contacts Source: https://support.callin.io/Create-AI-Agent/Contact-copied-2 Ajoutez des contacts manuellement ou via un CSV, gérez votre liste et lancez des campagnes depuis la page Contacts. ## Aperçu La page **Contacts** est l’endroit où vous gérez les personnes que vous allez appeler. Depuis ici, vous pouvez : * **Ajouter des contacts manuellement** (un ou plusieurs) * **Téléverser un CSV** pour importer une liste plus grande * **Rechercher et filtrer** votre liste de contacts * **Exporter** vos contacts au format CSV * **Démarrer des campagnes** à partir de contacts sélectionnés * **Supprimer la sélection** (action permanente) Pour ouvrir Contacts directement : [Cliquez ici pour aller à Contacts](https://app.callin.io/contacts)Capture : La page Contacts où vous pouvez ajouter/importer des contacts et gérer votre liste.
## Ajouter des contacts manuellement La saisie manuelle est idéale lorsque vous ajoutez quelques contacts rapidement (ou que vous collez des données depuis un tableur). ### Étapes 1. Cliquez sur **Add Contact**. 2. Renseignez les champs nécessaires : * **Name** (facultatif) * **Phone Number** (obligatoire) * **Email** (facultatif) 3. Ajoutez d’autres personnes en ajoutant d’autres lignes (si cette option est disponible dans votre fenêtre). > **Important :** **Phone Number est obligatoire** pour chaque contact. ### Astuces d’édition (comme un tableur) Dans la grille d’ajout de contacts, vous pouvez généralement : * Cliquer et glisser pour sélectionner plusieurs cellules * Copier/coller des valeurs dans la grille * Double-cliquer sur une cellule pour la modifier * Appuyer sur **Enter** pour ajouter une nouvelle ligne * Appuyer sur **Esc** pour effacer la sélection > **Astuce :** Si vos contacts sont déjà dans Google Sheets/Excel, copiez les cellules et collez-les directement dans la grille. ### Colonnes optionnelles Vous pouvez voir un bouton **Add Column** dans la fenêtre. Il permet d’ajouter des champs supplémentaires si votre espace de travail les prend en charge. > **Important :** Les colonnes disponibles peuvent varier selon votre compte ou votre offre. ## Importer des contacts depuis un CSV L’import CSV est recommandé pour les listes plus volumineuses. ### Exigences de téléversement * **Type de fichier :** CSV uniquement * **Taille maximale :** 10MB * Vous pouvez téléverser en sélectionnant un fichier ou par glisser-déposer. > **Erreur fréquente :** Téléverser un fichier .xlsx. Exportez-le d’abord au format **CSV**. ### Téléverser un CSV 1. Cliquez sur **Upload CSV**. 2. (Facultatif) Cliquez sur **Download Template** pour partir du format recommandé. 3. Téléversez votre CSV en cliquant sur **Select File** ou en glissant le fichier dans la zone de dépôt.Capture : Fenêtre de téléversement CSV, avec l’exigence CSV only et la limite de 10MB.
### Mapper vos colonnes Après le téléversement, vous associez les en-têtes de votre CSV aux champs que Callin importera. * **Phone** (obligatoire) * **Name** (facultatif) * **Email** (facultatif) > **Important :** Si **Phone** n’est pas mappé, l’import ne peut pas continuer. ### Règles de validation (s’appliquent au manuel + CSV) * Les numéros doivent inclure un **indicatif pays** (exemple : **+1234567890**) * Les numéros doivent comporter **7 à 15 chiffres** (hors indicatif pays) * Les numéros sont **obligatoires** pour tous les contacts * Les emails doivent être **valides** s’ils sont fournis * Les champs avec des erreurs de validation sont mis en évidence avec une **bordure rouge** * Les champs vides sont mis en évidence avec une **bordure rouge** > **Astuce :** Si votre CSV contient des numéros sans indicatif pays, ajoutez-le avant l’import pour éviter les erreurs de validation. ## Gérer votre liste de contacts ### Recherche et filtres * Utilisez **Search contacts…** pour trouver par nom, numéro ou email. * Cliquez sur **Filters** pour affiner votre liste. > **Important :** Les options de filtre peuvent varier selon votre compte ou votre offre. ### Voir et modifier Dans la colonne **Actions**, vous pouvez généralement : * **Voir** les détails d’un contact * **Modifier** le contact ### Exporter en CSV Cliquez sur **Export to CSV** pour télécharger votre liste actuelle de contacts. ## Démarrer une campagne depuis Contacts 1. Sélectionnez un ou plusieurs contacts avec les cases à cocher. 2. Cliquez sur **Start Campaign**. 3. Saisissez un **campaign name** et **select an agent**. 4. (Facultatif) Activez **Follow-up Calls**. Lorsqu’ils sont activés, les rappels sont planifiés pour chaque contact après un appel **unanswered** ou **busy** : * Après **2 hours** * Après **1 day** * Après **3 days** > **Astuce :** Pour un test, commencez avec une petite sélection (5 à 10 contacts) afin de vérifier que l’agent et le script se comportent comme prévu. ## Supprimer des contacts sélectionnés (permanent) 1. Sélectionnez les contacts à supprimer. 2. Cliquez sur **Delete Selected**. 3. Confirmez la suppression (vous devrez peut-être saisir **DELETE**). > **Important :** Il s’agit d’une action **permanente** et elle ne peut pas être annulée. # Contatti Source: https://support.callin.io/Create-AI-Agent/Contact-copied-3 Aggiungi contatti manualmente o da un CSV, gestisci la lista e avvia campagne dalla pagina Contacts. ## Panoramica La pagina **Contacts** è il punto in cui gestisci chi chiamare. Da qui puoi: * **Aggiungere contatti manualmente** (uno o più) * **Caricare un CSV** per importare una lista più grande * **Cercare e filtrare** la tua lista contatti * **Esportare** i contatti in CSV * **Avviare campagne** usando i contatti selezionati * **Eliminare i selezionati** (azione permanente) Per aprire Contacts direttamente: [Clicca qui per andare a Contacts](https://app.callin.io/contacts)Screenshot: La pagina Contacts dove puoi aggiungere/importare contatti e gestire la lista.
## Aggiungere contatti manualmente L’inserimento manuale è ideale quando devi aggiungere pochi contatti rapidamente (o incollare dati da un foglio di calcolo). ### Passaggi 1. Clicca **Add Contact**. 2. Compila i campi necessari: * **Name** (opzionale) * **Phone Number** (obbligatorio) * **Email** (opzionale) 3. Aggiungi altre persone aggiungendo altre righe (se disponibile nella finestra). > **Importante:** **Phone Number è obbligatorio** per ogni contatto. ### Suggerimenti di modifica (come un foglio di calcolo) Nella griglia di aggiunta contatti in genere puoi: * Cliccare e trascinare per selezionare più celle * Copiare e incollare valori nella griglia * Fare doppio clic su una cella per modificarla * Premere **Enter** per aggiungere una nuova riga * Premere **Esc** per cancellare la selezione > **Consiglio:** Se i contatti sono già in Google Sheets/Excel, copia le celle e incollale direttamente nella griglia. ### Colonne opzionali Potresti vedere il pulsante **Add Column** nella finestra. Serve per includere campi extra se il tuo workspace li supporta. > **Importante:** Le colonne disponibili possono variare in base all’account o al piano. ## Importare contatti da un CSV L’importazione CSV è consigliata per liste più grandi. ### Requisiti di caricamento * **Tipo file:** solo CSV * **Dimensione massima:** 10MB * Puoi caricare selezionando un file oppure trascinandolo e rilasciandolo. > **Errore comune:** Caricare un file .xlsx. Esportalo prima in **CSV**. ### Caricare un CSV 1. Clicca **Upload CSV**. 2. (Opzionale) Clicca **Download Template** per partire dal formato consigliato. 3. Carica il CSV cliccando **Select File** oppure trascinando il file nell’area di caricamento.Screenshot: Finestra di upload CSV, con requisito CSV only e limite di 10MB.
### Mappare le colonne Dopo il caricamento, associ le intestazioni del CSV ai campi che Callin importerà. * **Phone** (obbligatorio) * **Name** (opzionale) * **Email** (opzionale) > **Importante:** Se **Phone** non è mappato, l’importazione non può continuare. ### Regole di validazione (valgono per manuale + CSV) * I numeri devono includere il **prefisso internazionale** (esempio: **+1234567890**) * I numeri devono avere **7–15 cifre** (escludendo il prefisso internazionale) * I numeri sono **obbligatori** per tutti i contatti * Gli email devono essere **validi** se forniti * I campi con errori di validazione sono evidenziati con un **bordo rosso** * I campi vuoti sono evidenziati con un **bordo rosso** > **Consiglio:** Se nel CSV i numeri non hanno il prefisso internazionale, aggiungilo prima dell’importazione per evitare errori di validazione. ## Gestire la lista contatti ### Ricerca e filtri * Usa **Search contacts…** per trovare per nome, numero o email. * Clicca **Filters** per restringere la lista. > **Importante:** Le opzioni di filtro possono variare in base all’account o al piano. ### Visualizzare e modificare Nella colonna **Actions**, in genere puoi: * **Vedere** i dettagli del contatto * **Modificare** il contatto ### Esportare in CSV Clicca **Export to CSV** per scaricare la lista attuale dei contatti. ## Avviare una campagna da Contacts 1. Seleziona uno o più contatti usando le caselle. 2. Clicca **Start Campaign**. 3. Inserisci un **campaign name** e **select an agent**. 4. (Opzionale) Attiva **Follow-up Calls**. Quando attivi questa opzione, i follow-up vengono programmati per ogni contatto dopo una chiamata **unanswered** o **busy**: * Dopo **2 hours** * Dopo **1 day** * Dopo **3 days** > **Consiglio:** Se stai facendo una prova, inizia con una selezione piccola (5–10 contatti) per verificare che l’agente e lo script funzionino come previsto. ## Eliminare i contatti selezionati (permanent) 1. Seleziona i contatti che vuoi rimuovere. 2. Clicca **Delete Selected**. 3. Conferma l’eliminazione (potrebbe essere necessario digitare **DELETE**). > **Importante:** Questa è un’azione **permanente** e non può essere annullata. # Contactos Source: https://support.callin.io/Create-AI-Agent/Contact-copied-4 Añade contactos manualmente o desde un CSV, gestiona tu lista e inicia campañas desde la página de Contactos. ## Descripción general La página de **Contactos** es donde gestionas a quién vas a llamar. Desde aquí puedes: * **Añadir contactos manualmente** (uno o varios) * **Subir un CSV** para importar una lista grande * **Buscar y filtrar** tu lista de contactos * **Exportar** tus contactos a CSV * **Iniciar campañas** usando contactos seleccionados * **Eliminar seleccionados** (acción permanente) Para abrir Contactos directamente: [Haz clic aquí para ir a Contactos](https://app.callin.io/contacts)Captura: La página de Contactos donde puedes añadir/importar contactos y gestionar tu lista.
## Añadir contactos manualmente La entrada manual es ideal cuando vas a añadir pocos contactos (o pegar datos desde una hoja de cálculo). ### Pasos 1. Haz clic en **Add Contact**. 2. Rellena los campos que necesites: * **Name** (opcional) * **Phone Number** (obligatorio) * **Email** (opcional) 3. Añade más personas agregando más filas (si está disponible en tu modal). > **Importante:** **Phone Number es obligatorio** para cada contacto. ### Consejos de edición (como una hoja de cálculo) En la cuadrícula de añadir contactos normalmente puedes: * Hacer clic y arrastrar para seleccionar varias celdas * Copiar y pegar valores dentro de la cuadrícula * Hacer doble clic en una celda para editar * Pulsar **Enter** para añadir una fila nueva * Pulsar **Esc** para limpiar la selección > **Consejo:** Si ya tienes los contactos en Google Sheets/Excel, copia las celdas y pégalas directamente en la cuadrícula. ### Columnas opcionales Puede que veas un botón **Add Column** en el modal. Sirve para incluir campos extra si tu espacio de trabajo los soporta. > **Importante:** Las columnas disponibles pueden variar según tu cuenta o plan. ## Importar contactos desde un CSV La importación por CSV es lo mejor para listas grandes. ### Requisitos de subida * **Tipo de archivo:** solo CSV * **Tamaño máximo:** 10MB * Puedes subirlo seleccionando un archivo o arrastrándolo y soltándolo. > **Error común:** Subir un .xlsx. Primero expórtalo como **CSV**. ### Subir un CSV 1. Haz clic en **Upload CSV**. 2. (Opcional) Haz clic en **Download Template** para partir del formato recomendado. 3. Sube tu CSV haciendo clic en **Select File** o arrastrando el archivo al área de subida.Captura: Modal de subida de CSV, incluyendo el requisito de solo CSV y el límite de 10MB.
### Mapear tus columnas Después de subirlo, mapearás los encabezados del CSV con los campos que importará Callin. * **Phone** (obligatorio) * **Name** (opcional) * **Email** (opcional) > **Importante:** Si **Phone** no está mapeado, la importación no puede continuar. ### Reglas de validación (aplican a manual + CSV) * Los teléfonos deben incluir **código de país** (ejemplo: **+1234567890**) * Los teléfonos deben tener **7–15 dígitos** (excluyendo el código de país) * Los teléfonos son **obligatorios** para todos los contactos * Los emails deben ser **válidos** si se proporcionan * Los campos con errores de validación se resaltan con un **borde rojo** * Los campos vacíos se resaltan con un **borde rojo** > **Consejo:** Si tu CSV tiene teléfonos sin código de país, añade el código antes de importar para evitar errores de validación. ## Gestionar tu lista de contactos ### Búsqueda y filtros * Usa **Search contacts…** para encontrar por nombre, teléfono o email. * Haz clic en **Filters** para acotar tu lista. > **Importante:** Las opciones de filtro pueden variar según tu cuenta o plan. ### Ver y editar En la columna **Actions**, normalmente puedes: * **Ver** los detalles del contacto * **Editar** el contacto ### Exportar a CSV Haz clic en **Export to CSV** para descargar tu lista actual de contactos. ## Iniciar una campaña desde Contactos 1. Selecciona uno o varios contactos usando las casillas. 2. Haz clic en **Start Campaign**. 3. Escribe un **nombre de campaña** y **selecciona un agente**. 4. (Opcional) Activa **Follow-up Calls**. Si está activado, los seguimientos se programan para cada contacto después de una llamada **no contestada** o **ocupada**: * Tras **2 horas** * Tras **1 día** * Tras **3 días** > **Consejo:** Si estás probando, empieza con una selección pequeña (5–10 contactos) para confirmar que el agente y el guion funcionan como esperas. ## Eliminar contactos seleccionados (permanente) 1. Selecciona los contactos que quieres eliminar. 2. Haz clic en **Delete Selected**. 3. Confirma el borrado (puede que tengas que escribir **DELETE**). > **Importante:** Esta es una acción **permanente** y no se puede deshacer. # AI Agents Source: https://support.callin.io/Create-AI-Agent/Create-Agent-Enchanced How the Create Agent page works in Callin.io and what each of its seven sections does. [Open the AI Agents page in Callin.io](https://app.callin.io/agents) The **AI Agents** page is where you build and configure the agents that handle your phone calls and website conversations. Each agent has its own setup, divided into seven sections you can move through using the top tabs: **Agent**, **Workflow**, **Knowledge Base**, **Tools**, **Call Action**, **Website widget**, and **Advanced**. This page explains what each section does and what you can configure inside it.Screenshot: the Create Agent page. Each tab at the top opens a different part of the agent's configuration.
> **Tip:** Walk through the tabs in order the first time. Each one builds on the previous, and a clean setup is much easier to test and maintain later. ## Section 1: Agent The **Agent** tab is where you define the core identity and behavior of your assistant: how it should talk, which voice and language it uses, which AI model powers it, and whether it answers incoming calls, makes outgoing ones, or both. A good setup here makes every later section work better. A weak one creates problems that no workflow or tool can fix.Screenshot: the Agent tab, where you set the prompt, voice, language, model, and call direction.
### Conversation Prompt The **Conversation Prompt** is the main set of instructions your agent follows during a call. Think of it as the agent's playbook: who it is, the context it works in, the tone it should use, and the rules it must respect. The prompt template already includes three base sections you should fill in: * **Personality** — who the agent is and the role it plays. * **Environment** — the context it operates in (support call, appointment booking, reception, and so on). * **Tone** — how it should sound (calm, friendly, professional, brief). After those three, add operational rules that guide the agent's decisions during the call. Some that work well for most setups: * Ask only one clarifying question at a time. * Always move the user toward the next useful step. * Use the knowledge base for reference answers. * Keep responses short unless the user asks for detail. * Don't invent answers. If the information is unclear, say so. > **Tip:** Write the prompt as if you were briefing a new employee on their first day. Operational and clear, not decorative. ### Add Variables and Dynamic Variables The **Add Variables** button below the prompt editor lets you insert placeholders into your prompt — for example, the agent's name, the company, the city, or a service. You can use system variables, custom ones, or create a new variable on the spot. When you create a new variable, it appears as a chip below the editor and is added to the **Dynamic Variables** panel further down, where you assign its actual value. This is the right approach when you want to reuse the same agent for different brands, locations, or services without rewriting the prompt every time. ### Time zone Right next to the prompt editor there's a time zone selector (for example, **Madrid (GMT+1)**). This is the time reference the agent uses when it talks about *today*, *tomorrow*, *this afternoon*, or any specific time during the call. Always set it to the real time zone of the business the agent represents. A wrong time zone leads to wrong appointment times. ### Default personality **Default personality** is a base behavior preset that complements your prompt. Review it together with the prompt so the final tone matches what you actually want callers to hear. ### Greeting Message The **Greeting Message** is the very first thing the agent says when the call starts. A good greeting tells the caller who they're talking to and what kind of help is available, in one short sentence. A few examples: * Support: "Hi, I'm the support assistant. Tell me what's going on and I'll help you step by step." * Appointments: "Hi, I'm the booking assistant. I can help you schedule, change, or cancel an appointment." * Reception: "Hi, thanks for calling. I'm the virtual assistant and I'll help you with your request." ### Allow Interruptions When **Allow Interruptions** is on, callers can talk over the agent and the agent will stop and listen. This makes conversations feel natural and is a strong default for support, reception, and most customer service flows. > **Common mistake:** Turning interruptions off when your greeting includes critical information the caller must hear in full. If that's not your case, leave them on. ### Voice **Voice** controls how your agent sounds. The voice doesn't change what the agent says, but it heavily affects how callers feel during the call — clarity, trust, and overall impression. The **Select Voice** panel has three tabs: * **Explore** — the catalog of available voices, filtered by language and gender, with a short description for each. * **Cloned** — voices you've cloned or imported into your account. * **Add** — import a voice from ElevenLabs by pasting a shared link. You can also click **Add additional voice** to attach secondary voices, useful when one agent needs to handle several languages or different customer segments. Each voice has its own tuning controls: * **Expressive Mode** — how expressive the voice sounds. * **Speed** — how fast it speaks. * **Stability** — balance between expressiveness and consistency. * **Similarity** — how strongly it preserves its original vocal identity. ### Common voice settings Below the voice list there are two global audio controls: * **TTS output format** — the format of the generated audio. **PCM 16000 Hz** is the recommended option for most setups because it's a good balance between audio quality and processing speed. * **Optimize streaming latency** — controls the trade-off between how fast the agent starts speaking and the audio quality. More optimization means a faster start but slightly lower quality. ### Language **Language** sets the default language of the agent and the additional languages it can switch to mid-conversation. Only enable the languages you actually need. Adding extra languages "just in case" tends to make behavior less predictable. ### AI Intelligence (LLM) **AI Intelligence (LLM)** is the language model that powers the agent. The **LLM** (Large Language Model) is what understands the caller, follows the rules in your prompt, uses the knowledge base, and generates each response. The model directly affects three things: * How well the agent understands what the caller means. * How fast it answers (you'll see an approximate latency next to each model, like *\~179ms*). * How consistent it stays across long conversations. The models available include **Neuron 1.0**, **GPT-OSS 120B**, **GLM-4.5 Air**, **GPT-4.1 Nano**, **GPT-5 Nano**, **Gemini 2.5 Flash Lite**, **Gemini 2.5 Flash**, and **Claude Haiku 4.5**. For appointment-focused agents and scheduling flows, **Gemini 2.5** is a solid practical choice. ### Temperature **Temperature** controls how much variation the agent adds to its responses. Lower temperature means more stable and predictable answers. Higher temperature means more variation and less control. For support, appointments, and operational agents, keep temperature low. Save higher temperatures for creative or exploratory use cases. ### Call Direction **Call Direction** decides how the agent participates in the calling flow: * **Inbound** — the agent answers incoming calls (support, reception, customer service). * **Outbound** — the agent makes outgoing calls (campaigns, reminders, confirmations, follow-ups). * **Both** — the same agent works for incoming and outgoing calls. ### Saving and validation **Save** stores the current configuration. **Clear** discards unsaved edits. After every important change, run a real test call and check the greeting, the voice, the active languages, the selected model, and the values of any dynamic variables. > **Important:** A good agent setup must sound right on a real call, not just look right in the editor. ## Section 2: Workflow The **Workflow** tab is where you decide how the conversation moves. While the **Agent** tab defines who the assistant is, **Workflow** defines the path the call follows: branches based on what the caller wants, transfers, tool calls, and clean endings. You build it on a visual canvas by placing nodes and connecting them.Screenshot: the Workflow canvas, where you draw the conversation routes from start to end.
### What you can build here From a single starting point, you can: * Create multiple routes inside the same conversation. * Send the call to a **Subagent** for a specialized stage. * Transfer the call to another agent. * Transfer the call to a phone number. * Run a tool that already exists. * End the conversation with an **End** node. * Control which route applies using **LLM conditions**. ### Start **Start** is the entry point. Every conversation begins here. The node doesn't speak or act — it just launches the route and sends the call to the next node. The side panel for **Start** has two tabs: * **Overview** — explains its role. * **Edges** — lists every outgoing route from **Start**, with its label and destination. ### Transitions and LLM conditions A transition is the line that connects one node to the next. Each transition has a visible label and an **LLM condition** — a short text that tells the model when this route should apply. Examples of conditions: * "Use this route when the user needs technical help with the platform." * "Use this route when the user asks to speak with a person." * "Use this route when the issue is fully resolved and the conversation should end." Operational settings for transitions live in the **Forward** tab. ### Complete your workflow setup The **Complete your workflow setup** panel tells you exactly what's missing before the workflow can be saved properly. It's especially useful in larger flows because it points to the specific node or edge that still needs attention. Common items it flags: * An **Agent transfer** node without a target agent. * A **Tool** node without a tool selected. * A transition with no condition text. * A node or branch that's still incomplete. ### Subagent A **Subagent** is a specialized stage inside the same workflow. Use it when one part of the conversation needs its own goal, voice, model, or behavior, different from the main agent. Inside a Subagent node you can configure: * **General** — system prompt, override prompt, voice, LLM, eagerness, spelling patience. * **Knowledge Base** — toggle **Inherit knowledge base** to use the agent's main knowledge base, or set a different one. * **Tools** — toggle **Inherit custom tools** or attach specific tools with **Add Tool**. Tools themselves are not created here. They're created in the **Tools** section and only selected or inherited from inside the workflow. ### Tool node The **Tool** node (shown as **Tool dispatch** in the side panel) sends the conversation to a stage where the agent uses an existing tool. This node doesn't create new tools — it just points the workflow to a tool that already exists. ### Agent transfer **Agent transfer** hands the conversation over to another agent in your account. Use it when the call should move to an assistant specialized in another task, language, or workflow. You can configure: * The target agent. * A delay in milliseconds before the transfer. * A transfer message and whether to play it. Examples of transfer messages: * "I'm going to transfer you to the right agent for this request." * "I'll connect you with the assistant specialized in this type of question." ### Phone number transfer **Phone number transfer** sends the call out to a phone number. Use it when the conversation has to leave the agent and continue on a specific phone line. The destination type can be: * **Phone number** — a fixed number, ideal for reception, a sales line, or a dedicated support line. * **Phone dynamic variable** — the destination is decided at runtime based on the conversation context. ### End The **End** node closes the conversation. When the route reaches it, the call finishes. Use it when: * The issue is fully resolved. * A branch should close cleanly. * A stage is complete and shouldn't continue. ### Duplicate and delete Each node has controls to duplicate or delete it. **Duplicate** is handy for building similar branches faster. Before deleting, check the transitions connected to that node so you don't break a live route. ### Global settings **Global settings** affects the workflow as a whole. **Prevent infinite loops** adds a safety layer that avoids routes which could trap the conversation in a repeating cycle without progress. To disable a workflow without deleting it, disconnect the **Start** node. Without a connected start, the flow has no entry point and won't run. ### Save and test **Save** stores the current workflow. **Clear** discards unsaved edits. The unsaved-changes warning shows up when you have edits that haven't been saved yet. > **Common mistake:** A workflow that looks complete on the canvas can still fail in practice. Test every route with a real conversation before publishing. ## Section 3: Knowledge Base The **Knowledge Base** tab connects your agent to a source of reference content you've already prepared inside Callin.io. This gives the agent access to detailed information without having to cram it all into the prompt. Use it when the content is too long, too detailed, or changes too often to live inside the prompt.Screenshot: the Knowledge Base tab, where you link an existing knowledge source to the agent.
### What this tab is for This tab links an existing knowledge base to a specific agent. It does **not** create new content from scratch — that's done in the global Knowledge Base manager. Quick access: * [Open the Knowledge Base manager](https://app.callin.io/knowledge-base) A useful way to think about it: * The **prompt** defines how the agent should behave. * The **knowledge base** defines the reference content the agent can pull from when answering. ### When to use a knowledge base Use it when the content is: * Long (manuals, policies, internal documentation). * Frequently updated. * Already published as articles or pages. * Better kept separate from the prompt for easier maintenance. Typical sources: FAQs, product guides, support articles, policy documents, internal references. ### Supported content sources A knowledge base can be built from two types of sources: * **Files** — uploaded documents. * **Web URLs** — published pages or online documentation. You'll choose between them inside the **Select Knowledge Base** panel. ### What you see when a base is linked When the agent already has a knowledge base connected, the tab shows: * The selected group name. * The number of linked documents. * The available actions: **Clear**, **Update**, and **Change**. ### Main actions * **Change** — opens the **Select Knowledge Base** panel to pick a different base. * **Clear** — removes the currently linked knowledge base. * **Update** — refreshes the connection so the agent works with the latest version of the linked selection. ### Select Knowledge Base panel Clicking **Change** opens this panel. From here you can review what's available, pick a group, inspect its content, and confirm. What you'll find inside: * **Source** — switches between **Files** and **Web URLs**. * **Groups** — the list of knowledge bases inside the chosen source. * **Refresh** — reloads the list of groups. * **Documents / URLs** — the resources that belong to the selected group. * **Linked** — marker that shows a resource will be available to the agent once you confirm. * **Select** — confirms your choice. * **Close** — exits without changes. ### Recommended flow The cleanest way to work is to keep creation and selection separate: 1. Create and organize the knowledge base in the global manager. 2. Come back to this tab and link the prepared base to the agent. > **Tip:** Keep behavior rules in the prompt and reference content in the Knowledge Base. That separation makes updates much easier later. ## Section 4: Tools The **Tools** tab decides what your agent can actually *do* during a call beyond having a conversation. While the prompt defines how it talks and the workflow defines how the call moves, tools let the agent take action at the right moment. This tab does two things: it lets you attach **custom tools** built by your team, and it lets you enable and configure the **system tools** that Callin.io includes out of the box.Screenshot: the Tools tab, with the custom tools section on top and the system tools below.
Quick access: * [Open the global Tools section](https://app.callin.io/tools) ### Custom tools **Custom tools** are tools your team builds for specific use cases. They're not created inside the agent — first you build them in the global **Tools** section, and then you come back here to attach them. Typical things a custom tool can do: * Query an external system. * Run an automation. * Send or receive data through a **webhook** (a URL your tool calls when something happens). * Trigger business-specific logic. * Connect the agent to another service. If the agent doesn't have any custom tools attached yet, this area shows the empty state. The **Add Tool** button attaches a custom tool to the agent. If your account already has tools, the picker lets you search and select one. If there are none, it offers a direct option to create a **Webhook Tool**. ### System Tools **System Tools** are built-in tools that handle common call situations without you having to build anything. Each one can be turned on or off, and some have extra configuration. #### Smart Hang-up Lets the agent end the call cleanly when it detects the conversation is over — for example, when the caller says goodbye, confirms the issue is resolved, or clearly wraps up. This avoids keeping the line open longer than needed. #### Language Switching Helps the agent handle a language change during the call. Especially relevant when the agent works with multiple languages and the caller might switch at the start or in the middle of the conversation. #### Intelligent Listening Improves how the agent listens to and manages the conversation in real time. Controlled with a single activation toggle. #### Transfer to agent Hands the conversation over to another agent in your account. Useful for moving a call from a general agent to a specialist — for example, from a generic assistant to a sales agent or a senior support agent. #### Transfer to number Transfers the call to a human phone number. This is one of the most important tools when you need to escalate a call out of the agent and onto a real person — reception, a switchboard, sales, or a specific office. #### Human Transfer Rules Defines the specific rules for transferring to humans. Each rule includes: * **Destination Type** — a fixed phone number or a phone number provided through a dynamic variable. * **Phone Number** or the dynamic phone variable. * **Condition** — when this rule should apply. Use a fixed number when the destination is always the same, and a dynamic variable when it depends on the conversation context. #### Voicemail Intelligence Detects when the call has reached a voicemail and acts accordingly. This is critical for outbound agents, where calls often end up at voicemail. You have two options: * Leave the voicemail message blank if the call should end immediately on detection. * Write a message if you want the system to play it before ending the call. #### Description and Disable interruption Several system tools include two extra fields: * **Description** — explains to the model how and when the tool should be used. * **Disable interruption** — controls whether the tool can be interrupted while it's running. ### Choosing the right tools Don't enable everything. Pick what fits your use case: * An inbound support agent often uses **Smart Hang-up**, **Language Switching**, and **Intelligent Listening**. * An agent that escalates to humans uses **Transfer to number** with clear transfer rules. * An outbound agent often uses **Voicemail Intelligence**, **Smart Hang-up**, and **Language Switching**. > **Common mistake:** Enabling too many tools at once. It makes behavior harder to predict, harder to test, and harder to maintain. ## Section 5: Call Action The **Call Action** tab is where the agent stops being just a voice and starts producing useful outcomes: bookings, follow-up emails, logged issues, structured data, and synced records. Use it to turn the conversation into actual next steps your team can act on.Screenshot: the Call Action tab, where you automate what happens during and after each call.
Quick access: * [Set up Google Calendar](https://app.callin.io/actions/google-calendar) * [Set up Cal.com](https://app.callin.io/actions/cal) ### Appointment Scheduling Lets the agent book meetings directly during the call. Especially useful for sales, onboarding, and any flow where booking on the spot saves you from chasing the customer afterwards. Before turning it on, connect a scheduling provider: * **Google Calendar** — best when you want to book directly into a connected Google calendar. * **Cal.com** — best when your booking operation already runs on Cal.com. > **Important:** The agent's time zone and the calendar's time zone must match. If they don't, the agent will offer or confirm wrong times. ### Post-Call Summary Email Automatically sends an email once the call ends, so owners or teams stay in the loop without manual follow-up. You can configure: * The recipients. * The subject line. * The base message body. * The email language. * Whether to include call data. * Whether to include extracted fields (see *Information Capture* below). ### Smart Opt-Out Gives callers a clean and respectful way to say "don't contact me again." Important for outbound flows, where opt-out requests need to be captured and respected automatically. ### Issue and Complaint Tracking Detects issues or complaints during the call and logs them so your team can review, follow up, or escalate. Turn it on when you want each conversation to be able to create a case worth handling afterwards. ### Data Sync (Post-Call Webhook) Sends the captured call data to another system right after the call ends. The right choice when you work with a CRM, an automation platform, or any internal tool that needs the data without manual copy-paste. To set it up, enter the webhook URL that should receive the data, and confirm in advance which system will receive it and how it will process it. ### Information Capture (Data Extraction) Turns the conversation into structured data — names, dates, preferences, cities, products of interest, contact reasons, and so on. Use **Add Entity** to define what should be captured. Each entity has: * **Data Type** — the type of value to capture. * **Identifier** — the internal name used to store it. * **Description** — exactly what the system should extract. * **Enum Values** — an optional closed list of valid values, when you want consistent results. ### Capture and Store Contact Data When this is on, the extracted information gets saved into the contact's profile. Useful when you want to reuse this data on future calls or keep richer records of each contact. ### Call Retry Sets up automatic retries when a call doesn't connect. Mostly used in outbound agents, where calls often go unanswered or hit voicemail. You can configure: * **Retry Attempts** — how many times the system should try again before giving up. * **Wait Time Between Tries** — how many minutes to wait between attempts. > **Tip:** Only enable the actions that your team will actually use. Each automation you turn on is a small commitment to maintain. Fewer, well-chosen actions beat a long list of half-used ones. ## Section 6: Website widget The **Website widget** tab lets you publish your agent on a web page. Visitors can talk to it by voice, by chat, or both, directly from your site, landing page, support page, or client portal. This tab combines two things: the technical embed snippet, and the visual and textual customization of the experience.Screenshot: the Website widget tab, where you prepare the public widget and customize the visitor experience.
### Embed snippet The **Embed snippet** is the code fragment you copy into your site's HTML to make the widget appear. The **Copy** button copies it so you can paste it directly. Where to paste the snippet depends on the widget mode: * **Inline embed** — paste it exactly where you want the widget to render on the page. * **Floating launcher** — paste it near the end of the page body so it sits as a floating entry point. ### Layout & behavior This block decides how the widget gets embedded and how visitors interact with it. #### Widget mode How the widget appears on your site: * **Inline embed** — renders the full widget directly inside the page, where you placed the snippet. * **Floating launcher** — shows a floating button that opens the widget when clicked. #### Embed widget theme Controls the overall look: * **Match app theme** — follows whatever theme your site uses. * **Light** — light mode. * **Dark** — dark mode. Pick the option that fits your site's design. Readability and brand consistency come first. #### Conversation mode How visitors can interact: * **Voice only** — voice interaction only. * **Chat only** — text only. * **Voice + Chat** — both. ### Appearance Controls the visual style of the dial and the launcher. #### Widget variant and dial size * **Widget variant** — base visual size of the widget: **Tiny**, **Compact**, or **Full**. * **Dial size** — the minimum and maximum size of the dial, in pixels. #### Realtime transcript and mute button * **Realtime transcript** — shows a live transcript of the conversation while the call is happening. * **Show mute button** — shows a button so visitors can mute and unmute their microphone during the call. #### Orb colors * **Orb primary color** and **Orb secondary color** — the main colors of the widget. Use brand colors but keep enough contrast for readability. ### Dial labels Texts shown in the center of the dial depending on the conversation state: * **Center idle** * **Center connecting** * **Center listening** * **Center interrupt** ### Text labels General interface texts you can customize: * **Main label** * **Start call** * **Start chat** * **End call** * **Chatting status** * **Input placeholder for a new conversation** ### Chat UI labels Texts specific to the chat experience: * **Voice tab label** * **Chat tab label** * **Chat title** * **Chat subtitle** * **Chat status idle, connecting, and live** * **Chat start label** * **Chat end label** * **Chat empty state** * **Chat input placeholder idle and active** * **Chat send label** ### Adapting the widget to your use case A few combinations that work well: * **Commercial landing page** — Inline embed, light or matched theme, **Voice + Chat**, **Full** variant, contact-oriented copy. * **Website support** — Floating launcher, **Chat only** or **Voice + Chat**, **Compact** variant, help-oriented text. * **Voice-first experience** — Inline embed, **Voice only**, larger dial, visible mute button, short and direct labels. > **Tip:** Always preview the widget on the real page before publishing. Sizes, colors, and labels often feel different outside the editor. ## Section 7: Advanced The **Advanced** tab is where you fine-tune the agent: how it captures audio, how it handles silence, how it manages call data, and how it performs in outbound telephony scenarios. Most agents work fine without touching anything here. Open this tab when you want more precision, or when something specific isn't quite working.Screenshot: the Advanced tab, organized into four blocks for fine-tuning the agent.
The tab is split into four blocks: **Voice & Understanding**, **Conversation Flow**, **Privacy & Data**, and **Telephony Extras**. ### Voice & Understanding Adjusts how the agent captures audio and how it prioritizes specific terms. #### Speech Capture Quality Sets the audio format used to process speech. Options include **PCM 8000 Hz**, **PCM 16000 Hz**, **PCM 22050 Hz**, **PCM 24000 Hz**, **PCM 44100 Hz**, **PCM 48000 Hz**, and **ulaw 8000 Hz**. For most setups, leave it on **PCM 16000 Hz**. It's the best balance between audio quality and processing speed. **ulaw 8000 Hz** is specifically designed for telephony scenarios. #### Priority Keywords Lets you list terms the agent should prioritize when recognizing speech. Useful for brand names, product names, technical terms, acronyms, codes, or unusual surnames the model might otherwise mishear. ### Conversation Flow Controls the rhythm of the agent — how fast it joins in, how patient it is with slow speakers, and when it should hang up after silence. #### Eagerness How quickly the agent jumps in after the caller stops talking: * **Patient** — waits longer before responding. * **Normal** — balanced. * **Eager** — responds quickly. **Normal** works for most cases. #### Spelling patience Makes the agent more patient when the caller is slowly spelling something — names, emails, ID numbers. Options: * **Auto** — recommended when the agent often collects spelled-out information. * **Off** — keeps standard timing. #### Take turn after silence How many seconds of silence the agent waits before taking its turn. Lower values feel snappier; higher values give the caller more room to think. #### End conversation after silence How long a silence has to last before the call ends automatically. Useful when the caller stops responding entirely. #### Max conversation duration The maximum length of a single call. A safety net to prevent calls from running indefinitely. > **Tip:** If you're not sure what to set in the silence and duration fields, leave them at their default and only adjust them after testing real calls. ### Privacy & Data #### Record Calls When on, the system stores call audio and transcripts securely. Only enable this if it's compatible with your internal privacy, storage, and compliance policies. ### Telephony Extras Telephony-specific settings, mostly aimed at improving outbound call performance. #### Number Rotation Automatically rotates between your available phone numbers. Helps reduce the risk of a single number being flagged as spam, distributes call volume, and improves deliverability. #### Select Phone Numbers and Calls Per Number * **Select Phone Numbers** — picks which numbers will rotate. At least one is required when **Number Rotation** is on. * **Calls Per Number** — how many calls to make from one number before switching to the next. #### State-Based Restriction Limits calls so the agent dials with a local number from the same state as the contact. Designed for US local numbers — confirm your account has compatible local numbering before enabling it. > **Important:** Only change Advanced settings when you have a clear reason and can test the result with real calls. Random tweaks here usually create new problems instead of solving the old one. # KI-Agenten Source: https://support.callin.io/Create-AI-Agent/Create-Agent-Enchanced-copied-1 Erstellen, organisieren und konfigurieren Sie KI-Agenten für Telefongespräche und Website-Konversationen. [Öffnen Sie die Seite KI-Agenten in Callin](https://app.callin.io/agents) Die Seite **KI-Agenten** ist der zentrale Arbeitsbereich, um Agenten in Callin für Telefongespräche und Website-Konversationen zu erstellen, zu organisieren und zu konfigurieren. Von hier aus können Sie neue Agenten erstellen, bestehende Agenten bearbeiten, Wissensquellen verbinden, Tools zuweisen, Aktionen automatisieren, ein Website-Widget veröffentlichen und erweitertes Verhalten fein abstimmen.Screenshot: der Arbeitsbereich für KI-Agenten, in dem Sie das Hauptverhalten des Assistenten konfigurieren und alle Agentenbereiche von einer einzigen Seite aus aufrufen.
## Überblick über KI-Agenten Die Seite **KI-Agenten** ist der Hauptarbeitsbereich zum Erstellen und Verwalten von Agenten in Callin. Von hier aus können Sie alle Ihre Agenten an einem Ort sehen, erkennen, welche eingehend oder ausgehend sind, jede Konfiguration zur Bearbeitung öffnen und neue Agenten für unterschiedliche Geschäftsabläufe erstellen. Diese Seite ist besonders nützlich, wenn Sie einen neuen Agenten für Anrufe oder Website-Konversationen erstellen, Agenten nach Zweck trennen, eine vorhandene Konfiguration schnell finden und unvollständige Setups erkennen möchten, bevor Sie live gehen. In der Listenansicht können Sie normalerweise den Agentennamen, die Anrufrichtung, das Sprachlabel, das Erstellungsdatum und die Aktionssymbole prüfen. Möglicherweise sehen Sie auch Warnungen, wie etwa eine fehlende Telefonnummer, was Ihnen hilft, unvollständige Konfigurationen zu erkennen, bevor Sie den Agenten produktiv einsetzen. Um einen neuen Agenten zu erstellen, öffnen Sie die Seite KI-Agenten, klicken Sie auf **Agent erstellen**, wählen Sie aus, ob Sie von Grund auf beginnen oder eine Vorlage verwenden möchten, geben Sie den Agentennamen ein und bestätigen Sie dann die Erstellung. Diese Seite enthält: * **Agent** * **Arbeitsablauf** * **Wissensdatenbank** * **Tools** * **Anrufaktion** * **Website-Widget** * **Erweitert** > **Tipp:** Ein sauberes KI-Agenten-Setup ist einfacher zu testen, leichter zu pflegen und deutlich sicherer in die Produktion zu bringen. ## Abschnitt 1: AgentScreenshot: der Tab Agent, in dem Sie festlegen, wie sich der Assistent während eines Anrufs verhalten, sprechen, antworten und arbeiten soll.
Der Tab **Agent** definiert die Hauptkonfiguration Ihres Assistenten. Hier legen Sie fest, wie er sich während eines Anrufs verhalten soll, wie er das Gespräch eröffnen soll, welche Stimme er verwendet, welche Sprachen er verarbeiten kann, welches KI-Modell Antworten generiert und ob er für eingehende, ausgehende oder beide Arten von Anrufen arbeitet. Eine starke Konfiguration in diesem Tab sorgt für klarere, natürlichere und konsistentere Interaktionen. Ein generisches Setup führt normalerweise zu schwächeren Gesprächseröffnungen, ungenaueren Antworten und einem weniger kontrollierten Kundenerlebnis. ### Gesprächs-Prompt Der **Gesprächs-Prompt** ist der zentrale Anweisungssatz für den Agenten. Hier definieren Sie die Gesprächslogik, die Identität, den Arbeitskontext, den Tonfall und die operativen Grenzen. Dieser Block bestimmt, wie der Agent den Anruf interpretiert und wie er antworten soll. Er ist die interne Grundlage, die das Verhalten des Modells während des Gesprächs steuert. Die empfohlene Struktur ist die, die bereits im Prompt selbst organisiert ist. Die grundlegenden Abschnitte sind **Persönlichkeit**, **Umgebung** und **Tonfall**. Von dort aus sollte der Prompt mit operativen Regeln und klaren Einschränkungen fortgesetzt werden. * Definieren Sie, wer der Agent ist und welche Rolle er spielt. * Beschreiben Sie die Umgebung, in der er arbeitet. * Legen Sie den Tonfall fest, den der Agent beibehalten soll. * Erklären Sie, was der Agent in jeder Antwort priorisieren soll. * Legen Sie fest, was der Agent vermeiden muss. * Klären Sie, wie der Agent die Wissensdatenbank verwenden soll. * Definieren Sie, wie das Gespräch voranschreiten soll. ### So schreiben Sie einen guten Prompt Ein guter Prompt gibt dem Agenten eine klare Rolle, einen klaren Kontext und eine klare Entscheidungslogik. Er sollte operativ klingen, nicht dekorativ. Für Support-Agenten ist es praktisch, den Assistenten als First-Level-Support-Agent zu definieren, zu erklären, dass er Plattformnutzern hilft, und ihn anzuweisen, sich auf die Wissensdatenbank zu stützen, während er ruhig, präzise und Schritt für Schritt antwortet. * Stellen Sie immer nur eine Klärungsfrage auf einmal. * Führen Sie den Nutzer immer zum nächsten hilfreichen Schritt. * Verwenden Sie die Wissensdatenbank für Referenzantworten. * Erfassen Sie nur die Informationen, die für den aktuellen Schritt notwendig sind. * Halten Sie Antworten kurz, es sei denn, der Nutzer bittet um mehr Details. ### Was der Agent vermeiden sollte Der Prompt sollte auch Verhaltensweisen einschränken, die das Erlebnis verschlechtern. * Lange Monologe. * Mehrere Fragen in einer einzigen Runde. * Unnötige Wiederholungen. * Antworten erfinden, wenn Informationen unklar sind. * Einen Problemlösungsweg erzwingen, wenn der Fall eskaliert werden sollte. ### Dynamische Variablen im Prompt Der **Gesprächs-Prompt** unterstützt dynamische Variablen im Text. Mit diesen Variablen können Sie dieselbe Logik mit unterschiedlichen Werten wiederverwenden, ohne den gesamten Prompt neu schreiben zu müssen. Das Menü **Variablen hinzufügen** enthält Systemvariablen, benutzerdefinierte Variablen und die Option, eine neue Variable zu erstellen. Wenn Sie eine neue Variable erstellen, wird sie direkt in den Prompt eingefügt und steht anschließend unter **Dynamische Variablen** zur Verfügung, wo Sie ihr einen Wert zuweisen. Das ist nützlich für Werte wie den Namen des Agenten, den Firmennamen, die Stadt, den Servicenamen, den Namen eines Mitarbeiters oder den Namen eines Standorts. ### Zeitzone und Standardpersönlichkeit Der **Gesprächs-Prompt** enthält einen Zeitzonenwähler. Diese Einstellung definiert den zeitlichen Kontext, den der Agent verwendet, wenn er Uhrzeiten, Daten, Verfügbarkeiten oder Bezüge wie heute, morgen oder heute Nachmittag interpretieren muss. Wählen Sie immer die tatsächliche Zeitzone des Unternehmens oder Dienstes, den der Agent repräsentiert. Derselbe Bereich enthält auch die Einstellung **Standardpersönlichkeit**. Diese Einstellung gehört zum grundlegenden Persönlichkeitsverhalten und sollte zusammen mit dem Prompt geprüft werden, damit das endgültige Erlebnis dem gewünschten Verhalten entspricht. ### Begrüßungsnachricht Die **Begrüßungsnachricht** definiert die ersten Worte, die der Agent spricht, wenn das Gespräch beginnt. Sie stellt den Assistenten vor und macht sofort deutlich, welche Art von Hilfe verfügbar ist. Eine starke Begrüßung identifiziert den Assistenten, erklärt den Zweck der Interaktion und lädt den Nutzer ein, weiterzumachen. * **Support-Beispiel:** Hallo, ich bin der Support-Assistent. Sagen Sie mir, was Sie brauchen, und ich helfe Ihnen Schritt für Schritt. * **Termin-Beispiel:** Hallo, ich bin der Termin-Assistent. Ich kann Ihnen helfen, einen Termin zu buchen, zu ändern oder zu stornieren. * **Empfangs-Beispiel:** Hallo, danke für Ihren Anruf. Ich bin der virtuelle Assistent und helfe Ihnen bei Ihrem Anliegen. ### Unterbrechungen zulassen **Unterbrechungen zulassen** ermöglicht es dem Nutzer, den Agenten zu unterbrechen, während er spricht. Wenn diese Option aktiviert ist, fühlt sich die Interaktion flüssiger und natürlicher an. Das ist meist eine starke Standardeinstellung für Support, Empfang und allgemeinen Kundenservice. Wenn Ihre Eröffnungsnachricht eine kritische Anweisung enthält, die vollständig gehört werden muss, prüfen Sie diese Einstellung sorgfältig, bevor Sie live gehen. ### Dynamische Variablen **Dynamische Variablen** sammelt die Variablen, die eingefügt wurden, sowie den jeweils zugewiesenen Wert. Hier verwalten Sie die praktische Seite jeder Variable: Name und Wert. Dieser Bereich ist besonders nützlich, wenn Sie mit mehreren Kunden, Marken, Standorten oder Services arbeiten und dieselbe Agentenstruktur beibehalten möchten, während Sie nur die variierenden Daten ändern. ### Stimme **Stimme** definiert die Stimme, die der Agent während des Anrufs verwendet. Die Stimme verändert nicht die Logik des Assistenten, aber sie prägt stark, wie der Anruf in Bezug auf Klarheit, Vertrauen, Natürlichkeit und Gesamttönung wahrgenommen wird. Dieser Bereich umfasst eine primäre Stimme, die Option, zusätzliche Stimmen hinzuzufügen, stimmenspezifische Steuerungen sowie gemeinsame Ausgabe- und Latenzeinstellungen. * **Ausdrucksmodus** steuert, ob die Stimme ausdrucksvoller klingen soll. * **Geschwindigkeit** steuert, wie schnell die Stimme spricht. * **Stabilität** steuert das Gleichgewicht zwischen Ausdruck und Konsistenz. * **Ähnlichkeit** hilft der Stimme, eine konsistentere Stimmidentität zu bewahren. ### Stimme auswählen und zusätzliche Stimmen Die Stimmauswahl wird über **Stimme auswählen** verwaltet. Dieses Panel enthält **Entdecken**, **Geklont** und **Hinzufügen**. **Entdecken** enthält den verfügbaren Stimmenkatalog mit Suche, Sprachfilter, Geschlechtsfilter und einer kurzen Beschreibung für jede Stimme. **Geklont** enthält die geklonten oder importierten Stimmen, die in Ihrer Umgebung verfügbar sind. **Hinzufügen** ermöglicht es Ihnen, eine Stimme aus ElevenLabs über einen freigegebenen Link zu importieren und ihr einen Namen zuzuweisen, bevor sie dem Agenten hinzugefügt wird. **Zusätzliche Stimme hinzufügen** ist nützlich, wenn ein Agent sekundäre Stimmen für mehr Sprachen oder unterschiedliche Kundensegmente benötigt. ### Gemeinsame Stimmeinstellungen **Gemeinsame Stimmeinstellungen** umfassen zwei globale Konfigurationen: **TTS-Ausgabeformat** und **Streaming-Latenz optimieren**. Das **TTS-Ausgabeformat** definiert das Ausgabeformat des generierten Audios. **PCM 16000 Hz** erscheint als empfohlene Option. **Streaming-Latenz optimieren** steuert das Gleichgewicht zwischen Antwortgeschwindigkeit und Audioqualität. Eine stärker optimierte Latenz lässt den Agenten früher sprechen, kann aber die Audioqualität beeinflussen. ### Sprache **Sprache** definiert die primäre Sprache des Agenten und die zusätzlichen Sprachen, die er während des Gesprächs verarbeiten kann. Die Standardsprache ist die Sprache, die zu Beginn der Interaktion verwendet wird. Zusätzliche Sprachen ermöglichen es demselben Agenten, mehrsprachige Gespräche zu unterstützen. Aktivieren Sie nur die Sprachen, die Sie tatsächlich benötigen. Eine sauberere Konfiguration führt normalerweise zu stabilerem Verhalten. ### KI-Intelligenz **KI-Intelligenz** definiert das Sprachmodell, das der Agent verwendet, um den Nutzer zu verstehen und Antworten zu generieren. Diese Einstellung beeinflusst direkt die Qualität des Verständnisses, die Antwortgeschwindigkeit und die allgemeine Konsistenz. Das Sprachmodell ist das Gesprächsgehirn des Assistenten. Es versteht die Nutzerabsicht, hält den Anrufkontext aufrecht, folgt den im Prompt definierten Regeln, verwendet die Wissensdatenbank und erzeugt in jeder Runde die passende Antwort. Die in diesem Setup angezeigten Modelle umfassen **Neuron 1.0**, **GPT-OSS 120B**, **GLM-4.5 Air**, **GPT-4.1 Nano**, **GPT-5 Nano**, **Gemini 2.5 Flash Lite**, **Gemini 2.5 Flash** und **Claude Haiku 4.5**. Für terminorientierte Agenten und Planungsabläufe ist **Gemini 2.5** die praktische Empfehlung. ### Temperatur Die **Temperatur** steuert, wie viel Variation der Agent in seine Antworten einbringt. Eine niedrigere Temperatur erzeugt stabilere, fokussiertere und vorhersehbarere Antworten. Eine höhere Temperatur bringt mehr Variation und weniger Kontrolle. Für Support-, Service-, Termin- und operative Agenten ist eine kontrollierte Temperatur normalerweise die richtige Wahl. ### Anrufrichtung Die **Anrufrichtung** definiert, wie der Agent am Anruffluss teilnimmt. Die verfügbaren Modi sind **Ausgehend**, **Eingehend** und **Beides**. **Ausgehend** wird für ausgehende Anrufe wie Kampagnen, Erinnerungen, Bestätigungen und Nachfassaktionen verwendet. **Eingehend** wird für eingehende Anrufe wie Support, Empfang, Termine, Kundenservice oder allgemeine Informationen verwendet. **Beides** ermöglicht demselben Agenten, in beiden Szenarien zu arbeiten. ### Speichern und Validierung **Speichern** speichert die aktuelle Agentenkonfiguration. **Leeren** entfernt oder setzt die aktuellen nicht gespeicherten Änderungen zurück. Jede größere Änderung sollte durch reale Tests validiert werden, bevor die Konfiguration als abgeschlossen gilt. Dazu gehört die Prüfung der Eröffnungsnachricht, das Anhören der Stimme, die Validierung der aktiven Sprachen, die Bestätigung des ausgewählten Modells, die Bestätigung der Anrufrichtung und die Überprüfung der Werte dynamischer Variablen. > **Wichtig:** Ein gutes Agenten-Setup sollte in einem echten Anruf klar klingen und nicht nur im Editor korrekt aussehen. ## Abschnitt 2: ArbeitsablaufScreenshot: die Arbeitsablauf-Fläche, auf der Sie die Entscheidungslogik, Verzweigungen und Routing-Struktur des Gesprächs aufbauen.
Der **Arbeitsablauf** definiert die Entscheidungsstruktur des Agenten. Während der Tab **Agent** die Gesamtidentität des Assistenten festlegt, bestimmt der **Arbeitsablauf**, welchen Weg das Gespräch je nach Nutzerabsicht und der von Ihnen entworfenen Logik nehmen soll. In diesem Bereich erstellen Sie die visuellen Gesprächsrouten, Bedingungen, Weiterleitungen, Tool-Stufen und Endpunkte, die organisieren, wie sich der Anruf von einem Schritt zum nächsten bewegt. ### Was Sie im Arbeitsablauf tun können Der **Arbeitsablauf** ermöglicht es Ihnen, einen visuellen Pfad für das Gespräch zu erstellen. Von einem einzigen Einstiegspunkt aus können Sie Verzweigungen anlegen, den Anruf an einen spezialisierten Unteragenten senden, ihn an einen anderen Agenten oder an eine Telefonnummer weiterleiten, Tools verwenden und das Gespräch beenden, wenn die Route nicht fortgesetzt werden soll. * Den Ablauf bei **Start** beginnen. * Mehrere Routen innerhalb desselben Gesprächs erstellen. * Spezialisierte Unteragenten verwenden. * Den Anruf an einen anderen Agenten weiterleiten. * Den Anruf an eine Telefonnummer weiterleiten. * Bereits vorhandene Tools ausführen. * Das Gespräch mit einem **Ende**-Knoten schließen. * Jede Route mit einer **LLM-Bedingung** steuern. ### Wie die Fläche organisiert ist Der Hauptbereich des **Arbeitsablaufs** ist eine visuelle Fläche, auf der Sie Knoten platzieren und jeden Knoten mit seinem nächsten Schritt verbinden. Der Ablauf beginnt bei **Start** und erweitert sich dann zu einer oder mehreren Routen. In der oberen linken Ecke der Fläche helfen Zoom-Steuerungen dabei, sich durch den Arbeitsablauf zu bewegen, wenn die Logik komplexer wird. ### Start **Start** ist der Einstiegspunkt des Arbeitsablaufs. Jedes Gespräch beginnt hier. Dieser Knoten antwortet nicht selbstständig und führt keine direkten Aktionen aus. Seine Aufgabe ist es, die Route zu starten und das Gespräch an den richtigen nächsten Knoten zu senden. Der Tab **Übersicht** erklärt die Rolle von **Start** im Ablauf. Der Tab **Verbindungen** listet jede ausgehende Route auf, die von **Start** erstellt wurde, zusammen mit jedem Label und Zielknoten. ### Übergänge und Bedingungen Übergänge sind die Verbindungen, die einen Knoten mit einem anderen verknüpfen. In diesem Setup ist der verfügbare Übergangstyp die **LLM-Bedingung**. Jeder Übergang enthält ein sichtbares Label und einen Text für die **LLM-Bedingung**, der definiert, wann diese Route angewendet werden soll. * Verwenden Sie diese Route, wenn der Nutzer technische Hilfe mit der Plattform benötigt. * Verwenden Sie diese Route, wenn der Nutzer mit einer Person sprechen möchte. * Verwenden Sie diese Route, wenn das Problem vollständig gelöst ist und das Gespräch enden soll. ### Vorwärts und Rückwärts Die operative Konfiguration erfolgt in **Vorwärts**. **Rückwärts** bietet in dieser Version keine zusätzliche Konfiguration. ### Vervollständigen Sie Ihr Arbeitsablauf-Setup Der **Arbeitsablauf** enthält ein Validierungsfeld mit dem Namen **Vervollständigen Sie Ihr Arbeitsablauf-Setup**. Dieses Feld zeigt Ihnen genau an, was noch fehlt, bevor der Ablauf korrekt gespeichert werden kann. Das ist besonders bei komplexen Arbeitsabläufen nützlich, weil es genau auf den Knoten oder die Verbindung hinweist, die noch Aufmerksamkeit benötigt. * Ein Knoten für **Agentenweiterleitung** hat keinen Zielagenten. * Ein **Tool**-Knoten hat kein ausgewähltes Tool. * Einem Übergang fehlt sein Bedingungstext. * Ein Knoten oder eine Verzweigung ist noch unvollständig. ### Unteragent Der **Unteragent** ermöglicht es Ihnen, innerhalb desselben Arbeitsablaufs eine spezialisierte Gesprächsphase zu erstellen. Verwenden Sie ihn, wenn ein Teil des Ablaufs ein eigenes Verhalten, ein engeres Ziel oder eine andere Konfiguration als der Hauptagent benötigt. * Verwenden Sie ihn, wenn eine Phase des Ablaufs ein eigenes Ziel braucht. * Verwenden Sie ihn, wenn ein Teil des Gesprächs eine andere Stimme oder ein anderes Modell erfordert. * Verwenden Sie ihn, wenn Sie Kontrolle über Wissen oder Tools auf Knotenebene brauchen. ### Unteragent - Allgemeine Einstellungen Im Tab **Allgemein** können Sie für diesen Knoten den **System-Prompt**, **Prompt überschreiben**, die **Stimme**, das **LLM**, den **Reaktionsgrad** und die **Buchstabiergeduld** konfigurieren. Ein Unteragent ist nützlich für spezialisierte Support-Phasen, Informationssammlungsstufen vor einer Weiterleitung oder Routen, die einen anderen Sprechstil benötigen. ### Unteragent - Wissensdatenbank und Tools Der Tab **Wissensdatenbank** enthält **Wissensdatenbank übernehmen**. Wenn diese Option aktiviert ist, übernimmt der Knoten die Wissensdatenbank des Agenten. Der Tab **Tools** enthält **Benutzerdefinierte Tools übernehmen** und **Tool hinzufügen**. Wenn die Übernahme aktiviert ist, verwendet der Knoten die benutzerdefinierten Tools des Agenten. Tools werden nicht im **Arbeitsablauf** erstellt. Sie werden im Bereich **Tools** erstellt und konfiguriert. Im **Arbeitsablauf** werden sie nur ausgewählt oder übernommen. ### Tool-Knoten Der **Tool**-Knoten wird verwendet, um das Gespräch an eine Phase zu senden, in der der Agent bereits vorhandene Tools verwenden kann. Im Seitenpanel erscheint dies als **Tool-Zuweisung**. Dieser Knoten erstellt keine neuen Tools. Seine Aufgabe ist es, den Arbeitsablauf mit Tools zu verbinden, die bereits an anderer Stelle konfiguriert wurden. ### Agentenweiterleitung Die **Agentenweiterleitung** sendet das Gespräch an einen anderen Agenten in Ihrem Konto. Das ist die richtige Option, wenn die Interaktion an einen anderen Assistenten übergeben werden muss, der auf eine andere Aufgabe, eine andere Sprache oder einen anderen Arbeitsablauf spezialisiert ist. Sie können den Zielagenten auswählen, eine Verzögerung in Millisekunden festlegen, eine Weiterleitungsnachricht schreiben und entscheiden, ob diese erste Nachricht abgespielt werden soll. * Ich werde Sie an den richtigen Agenten für dieses Anliegen weiterleiten. * Ich verbinde Sie jetzt mit dem Assistenten, der auf diese Art von Frage spezialisiert ist. ### Weiterleitung an Telefonnummer Die **Weiterleitung an Telefonnummer** sendet den Anruf an eine Telefonnummer. Verwenden Sie diesen Knoten, wenn das Gespräch den Agenten verlassen und über eine bestimmte Telefonleitung fortgesetzt werden soll. Die verfügbaren Zieltypen sind **Telefonnummer** und **Dynamische Telefonvariable**. **Telefonnummer** ist die richtige Wahl für ein festes Ziel, etwa Empfang, eine dedizierte Vertriebsleitung oder eine feste Support-Leitung. **Dynamische Telefonvariable** ist die richtige Wahl, wenn das Ziel vom Kontext des Ablaufs abhängt. ### Ende **Ende** ist der Knoten, der das Gespräch schließt. Wenn der Ablauf diesen Punkt erreicht, endet die Interaktion. * Verwenden Sie **Ende**, wenn das Problem vollständig gelöst ist. * Verwenden Sie **Ende**, wenn eine Verzweigung ohne Fortsetzung geschlossen werden soll. * Verwenden Sie **Ende**, wenn eine Phase abgeschlossen ist und die Route nicht weitergehen soll. ### Duplizieren und Löschen Jeder Knoten enthält Steuerelemente zum Duplizieren oder Löschen. **Duplizieren** kopiert einen vorhandenen Knoten, damit Sie ähnliche Verzweigungen schneller erstellen können. **Löschen** entfernt den Knoten aus dem Ablauf. Bevor Sie einen Knoten löschen, prüfen Sie seine verbundenen Übergänge, damit keine aktive Route unterbrochen wird. ### Globale Einstellungen Die **Globalen Einstellungen** enthalten Optionen, die den gesamten Arbeitsablauf betreffen. **Unendliche Schleifen verhindern** fügt eine Sicherheitsebene hinzu, die dabei hilft, Routen zu vermeiden, die das Gespräch ohne Fortschritt in einer wiederholenden Schleife festhalten könnten. Um einen Arbeitsablauf zu deaktivieren, trennen Sie den **Start**-Knoten. Ohne verbundenen **Start** hat der Ablauf keinen operativen Einstiegspunkt mehr. ### Speichern und Testen **Speichern** speichert den aktuellen Arbeitsablauf. **Leeren** entfernt oder setzt den aktuellen Bearbeitungszustand zurück. Die Warnung zu nicht gespeicherten Änderungen zeigt an, dass noch Bearbeitungen vorhanden sind, die nicht gespeichert wurden. Testen Sie immer jede Route einzeln, bevor Sie veröffentlichen. > **Häufiger Fehler:** Ein Arbeitsablauf kann auf der Fläche vollständig aussehen und in der Praxis trotzdem scheitern, wenn ein Knoten, ein Tool oder eine Bedingung nie mit einem echten Gespräch getestet wurde. ## Abschnitt 3: WissensdatenbankScreenshot: der Tab Wissensdatenbank, in dem Sie eine vorhandene Quelle mit Referenzinhalten mit dem Agenten verbinden.
Die **Wissensdatenbank** verbindet Ihren Agenten mit einer Wissensquelle, die bereits in Callin vorbereitet wurde. Dadurch erhält der Agent Zugriff auf breitere, strukturierte und wiederverwendbare Referenzinhalte, sodass er mit detaillierteren Informationen antworten kann als jenen, die direkt im Haupt-Prompt stehen sollten. Verwenden Sie diesen Bereich, wenn die Informationen zu lang, zu detailliert, zu strukturiert oder zu dynamisch sind, um direkt im Prompt gepflegt zu werden. ### Schnellzugriff * [Öffnen Sie den Verwalter der Wissensdatenbank](https://app.callin.io/knowledge-base) ### Wann die Wissensdatenbank verwendet werden sollte Die **Wissensdatenbank** ist die richtige Wahl, wenn Inhalte umfangreich sind, sich häufig ändern, bereits als Dokumentation existieren oder getrennt vom Haupt-Prompt bleiben sollen, um die Pflege zu erleichtern. * Handbücher. * Häufig gestellte Fragen. * Richtlinien. * Produktleitfäden. * Support-Artikel. * Internes Referenzmaterial. ### Was dieser Tab macht Dieser Tab wird verwendet, um eine bestehende Wissensdatenbank mit einem bestimmten Agenten zu verknüpfen. Er erstellt keine neuen Inhalte von Grund auf. Der Prompt definiert, wie sich der Agent verhalten soll, während die **Wissensdatenbank** definiert, welche zusätzlichen Referenzinhalte der Agent bei Antworten verwenden kann. ### Unterstützte Inhaltsquellen Die **Wissensdatenbank** kann mit zwei Quellen arbeiten: **Dateien** und **Web-URLs**. Verwenden Sie **Dateien**, wenn die Wissensdatenbank aus hochgeladenen Dokumenten aufgebaut ist. Verwenden Sie **Web-URLs**, wenn die Wissensdatenbank aus veröffentlichten Seiten oder Dokumentationen besteht, die per URL erreichbar sind. ### Was Sie sehen, wenn eine Datenbank verknüpft ist Wenn bereits eine Wissensdatenbank mit dem Agenten verbunden ist, zeigt der Tab den Namen der ausgewählten Gruppe, die Anzahl der verknüpften Dokumente und die verfügbaren Aktionen zur Verwaltung dieser Verbindung an. * Name der ausgewählten Gruppe. * Anzahl der verknüpften Dokumente. * **Leeren**. * **Aktualisieren**. * **Ändern**. ### Hauptaktionen **Ändern** öffnet das Panel **Wissensdatenbank auswählen** und ermöglicht es Ihnen, eine andere Wissensdatenbank für den Agenten auszuwählen. **Leeren** entfernt die derzeit mit dem Agenten verbundene Wissensdatenbank. **Aktualisieren** aktualisiert die aktuelle Verbindung, damit der Agent mit der neuesten verknüpften Auswahl arbeitet. ### Panel Wissensdatenbank auswählen Wenn Sie auf **Ändern** klicken, öffnet sich das Panel **Wissensdatenbank auswählen**. Dieses Panel dient dazu, verfügbare Quellen zu prüfen, eine Gruppe auszuwählen, ihre Dokumente oder URLs einzusehen und die endgültige Auswahl zu bestätigen. * **Quelle** wechselt zwischen **Dateien** und **Web-URLs**. * **Gruppen** listet die verfügbaren Wissensdatenbanken innerhalb der ausgewählten Quelle auf. * **Aktualisieren** erneuert die Liste der Gruppen. * **Dokumente / URLs** zeigt die Ressourcen an, die in der ausgewählten Gruppe enthalten sind. * **Verknüpft** bedeutet, dass die Ressource zur ausgewählten Datenbank gehört und nach Bestätigung der Verbindung für den Agenten verfügbar ist. * **Auswählen** bestätigt die gewählte Wissensdatenbank. * **Schließen** verlässt das Panel, ohne eine neue Auswahl anzuwenden. ### Wie der Auswahlablauf funktioniert Der empfohlene Ablauf ist immer derselbe: Erstellen und organisieren Sie zuerst die Wissensdatenbank im allgemeinen Verwalter und kehren Sie dann zum Agenten zurück, um diese vorbereitete Quelle in diesem Tab zu verbinden. Dadurch bleiben Erstellung und Auswahl getrennt. Der allgemeine Verwalter erstellt die Wissensdatenbank. Der Agenten-Tab verbindet sie mit dem Gespräch. ### Bewährte Vorgehensweisen Verknüpfen Sie nur nützliche und relevante Inhalte. Organisieren Sie Gruppen nach Zweck. Verwenden Sie klare Gruppennamen. Prüfen Sie die ausgewählte Gruppe vor dem Speichern. Aktualisieren Sie die Verbindung nach wichtigen Änderungen. Halten Sie das Verhalten des Agenten im Prompt und die Referenzinhalte in der **Wissensdatenbank**. ### Was dieser Tab nicht macht Der Tab **Wissensdatenbank** des Agenten dient nicht dazu, den Haupt-Prompt zu schreiben, Tools zu konfigurieren, Arbeitsabläufe zu bauen oder eine Wissensquelle von Grund auf zu erstellen. Seine Aufgabe ist klar: eine vorhandene Wissensdatenbank auszuwählen und mit dem Agenten zu verknüpfen. > **Tipp:** Platzieren Sie Verhaltensregeln im Prompt und wiederverwendbare Referenzinhalte in der Wissensdatenbank. Diese Trennung macht Aktualisierungen deutlich einfacher. ## Abschnitt 4: ToolsScreenshot: der Tab Tools, in dem Sie benutzerdefinierte Tools anhängen und die integrierten Tools aktivieren, die der Agent während eines Anrufs verwenden kann.
Der Tab **Tools** definiert, welche Tools Ihr Agent während eines Anrufs verwenden kann. Dieser Bereich wird für zwei verschiedene Dinge verwendet: das Hinzufügen benutzerdefinierter Tools zum Agenten und das Aktivieren oder Konfigurieren der bereits in Callin enthaltenen System-Tools. Tools erweitern, was der Agent während eines Gesprächs tun kann. Während der Prompt festlegt, wie der Agent sprechen soll, und der **Arbeitsablauf** definiert, wie der Anruf voranschreiten soll, ermöglichen Tools dem Agenten, bestimmte Verhaltensweisen im richtigen Moment auszuführen. ### Schnellzugriff * [Öffnen Sie den globalen Bereich Tools](https://app.callin.io/tools) ### Zwei Arten von Tools Dieser Bereich vereint zwei unterschiedliche Gruppen von Tools: **Benutzerdefinierte Tools** und **System-Tools**. ### Benutzerdefinierte Tools **Benutzerdefinierte Tools** sind Tools, die Ihr Team für bestimmte Anwendungsfälle erstellt. Sie werden nicht im Agenten-Tab erstellt. Zuerst erstellen Sie sie im plattformweiten Bereich **Tools**. Dann kehren Sie zum Agenten zurück und fügen sie in diesem Tab hinzu. * Ein externes System abfragen. * Eine Automatisierung ausführen. * Daten über einen Webhook senden oder empfangen. * Geschäftsspezifische Logik auslösen. * Den Agenten mit einem anderen Dienst verbinden. ### Hauptbereich für benutzerdefinierte Tools Der Hauptbereich des Tabs **Tools** zeigt die benutzerdefinierten Tools an, die bereits mit dem Agenten verknüpft sind. Wenn dem Agenten noch keine benutzerdefinierten Tools zugeordnet sind, zeigt der Bereich den entsprechenden Leerzustand. ### Tool hinzufügen **Tool hinzufügen** wird verwendet, um ein benutzerdefiniertes Tool an den Agenten anzuhängen. Wenn Ihr Konto bereits Tools enthält, können Sie sie über diese Schaltfläche suchen und auswählen. Wenn noch keine Tools vorhanden sind, bietet die Auswahl direkt die Möglichkeit, ein **Webhook-Tool** zu erstellen. ### System-Tools **System-Tools** sind integrierte Callin-Tools, die bereits innerhalb des Agenten verfügbar sind. Sie wurden dafür entwickelt, häufige Gesprächssituationen zu bewältigen, ohne dass Sie neue Tools von Grund auf erstellen müssen. Diese Tools können einzeln aktiviert oder deaktiviert werden, und einige davon enthalten erweiterte Konfigurationsmöglichkeiten. ### Intelligentes Auflegen **Intelligentes Auflegen** ermöglicht es dem Agenten, einen Anruf korrekt zu beenden, wenn erkannt wird, dass das Gespräch bereits abgeschlossen ist. Dieses Tool ist für natürliche Gesprächsenden gedacht und hilft zu vermeiden, dass ein Anruf unnötig offen bleibt, nachdem der Nutzer klar fertig ist. * Der Nutzer verabschiedet sich. * Der Nutzer sagt, dass das alles war. * Der Nutzer bestätigt, dass das Problem gelöst ist. * Das Gespräch hat seinen klaren Abschluss erreicht. ### Sprachwechsel **Sprachwechsel** ermöglicht es dem Agenten, Sprachwechsel während des Gesprächs zu handhaben. Dieses Tool ist besonders wichtig, wenn der Agent in mehreren Sprachen arbeitet und der Nutzer am Anfang oder mitten im Anruf die Sprache wechseln kann. ### Intelligentes Zuhören **Intelligentes Zuhören** ist ein System-Tool, das verbessert, wie der Agent das Gespräch in Echtzeit anhört und verwaltet. Dieses Tool wird über den Aktivierungsschalter gesteuert. ### An Agenten weiterleiten **An Agenten weiterleiten** ermöglicht es dem Agenten, das Gespräch an einen anderen Agenten zu übergeben. Das ist nützlich, wenn ein Anruf an einen anderen spezialisierten Assistenten in Ihrem Konto übergehen muss. * Von einem allgemeinen Agenten zu einem Support-Agenten. * Von einem ersten Agenten zu einem Vertriebs-Agenten. * Von einem Mehrzweck-Agenten zu einem Spezialisten. ### An Nummer weiterleiten **An Nummer weiterleiten** ermöglicht es dem Agenten, den Anruf an eine menschliche Telefonnummer weiterzuleiten. Dies ist eines der wichtigsten Tools, wenn ein Gespräch aus dem Agenten heraus eskaliert und an eine Person oder eine bestimmte Leitung übergeben werden muss. * Empfang. * Menschlicher Support. * Vertrieb. * Eine Telefonzentrale. * Ein bestimmtes Büro oder ein bestimmter Ansprechpartner. ### Regeln für menschliche Weiterleitung **Regeln für menschliche Weiterleitung** ist der Bereich, in dem Sie die konkreten Regeln für die Weiterleitung des Anrufs an menschliche Mitarbeitende definieren. Jede Regel enthält **Zieltyp**, **Telefonnummer** oder eine dynamische Telefonvariable und **Bedingung**. Der **Zieltyp** kann eine feste Telefonnummer oder eine Telefonnummer sein, die über eine dynamische Variable bereitgestellt wird. Die **Bedingung** definiert, wann diese spezifische Weiterleitungsregel angewendet werden soll. ### Mailbox-Intelligenz **Mailbox-Intelligenz** erkennt, wenn der Anruf eine Mailbox erreicht hat, und reagiert entsprechend. Dieses Tool ist besonders wichtig bei ausgehenden Agenten, weil Sie damit festlegen können, was passieren soll, wenn keine Person antwortet und eine Mailbox-Begrüßung erkannt wird. * Lassen Sie die Mailbox-Nachricht leer, wenn der Anruf sofort beendet werden soll, sobald eine Mailbox erkannt wird. * Schreiben Sie eine Mailbox-Nachricht, wenn das System vor dem Beenden des Anrufs eine Nachricht abspielen soll. ### Beschreibung und Unterbrechung deaktivieren Mehrere System-Tools enthalten ein Feld **Beschreibung** und eine Steuerung **Unterbrechung deaktivieren**. Die **Beschreibung** erklärt dem Modell, wie und wann das Tool verwendet werden soll. **Unterbrechung deaktivieren** steuert, ob die Ausführung des Tools unterbrochen werden kann, während es läuft. ### So wählen Sie die richtigen Tools aus Aktivieren Sie nicht standardmäßig jedes Tool. Die richtige Auswahl hängt davon ab, wie Ihr Assistent arbeiten soll. Ein eingehender Support-Agent kann **Intelligentes Auflegen**, **Sprachwechsel** und **Intelligentes Zuhören** verwenden. Ein Agent, der an Menschen eskaliert, kann **An Nummer weiterleiten** zusammen mit klar definierten Weiterleitungsregeln verwenden. Ein ausgehender Agent kann **Mailbox-Intelligenz**, **Intelligentes Auflegen** und **Sprachwechsel** verwenden. ### Bewährte Vorgehensweisen Aktivieren Sie nur die Tools, die der Agent tatsächlich benötigt. Passen Sie System-Tools an, wenn Ihr Betrieb es erfordert. Verwenden Sie klare Beschreibungen. Definieren Sie spezifische Bedingungen in Weiterleitungsregeln. Verwenden Sie feste Nummern, wenn das Ziel immer gleich ist, und dynamische Variablen, wenn das Ziel vom Kontext abhängt. Erstellen Sie benutzerdefinierte Tools im globalen Bereich **Tools**, bevor Sie sie dem Agenten hinzufügen. Prüfen Sie nach dem Speichern immer das reale Verhalten. > **Häufiger Fehler:** Zu viele gleichzeitig aktivierte Tools machen das Verhalten in der Regel schwerer vorhersehbar, schwerer testbar und schwerer wartbar. ## Abschnitt 5: AnrufaktionScreenshot: der Tab Anrufaktion, in dem Sie automatisieren, was während und nach jedem Anruf passieren soll.
**Anrufaktion** automatisiert, was während und nach jedem Anruf passiert, damit Ihr Agent Gespräche in Nachverfolgung, Organisation und praktische nächste Schritte umwandeln kann. Verwenden Sie **Anrufaktion**, wenn Ihr Agent mit dem Anruf etwas Nützliches tun soll und nicht nur das Gespräch führen soll. Die beste Konfiguration ist nicht die mit den meisten aktivierten Aktionen. Es ist die, die nur die Aktionen aktiviert, die Ihrem Arbeitsablauf echten Mehrwert bringen. ### Schnellzugriff * [Google Calendar einrichten](https://app.callin.io/actions/google-calendar) * [Cal.com einrichten](https://app.callin.io/actions/cal) ### Was Anrufaktion macht **Anrufaktion** bündelt die Automatisierungen, die Ihr Agent während des Anrufs oder direkt nach dessen Ende ausführen kann. Dieser Bereich verwandelt ein Gespräch in praktische Ergebnisse: einen Termin buchen, eine Nachfass-E-Mail senden, Probleme protokollieren, Daten mit anderen Apps synchronisieren, strukturierte Informationen extrahieren und automatische Wahlwiederholungen festlegen. * Termine direkt in einem Kalender buchen. * Nach Gesprächsende automatisch eine Zusammenfassungs-E-Mail senden. * Dem Anrufer eine klare Möglichkeit geben, zukünftigen Kontakt abzulehnen. * Während des Gesprächs erkannte Probleme oder Beschwerden protokollieren. * Erfasste Daten über einen Post-Call-Webhook an andere Systeme senden. * Strukturierte Informationen aus dem Gespräch extrahieren. * Extrahierte Daten im Kontaktprofil speichern. * Automatische Wiederholungsversuche konfigurieren, wenn ein Anruf nicht abgeschlossen wird. ### Terminplanung **Terminplanung** ermöglicht es dem Agenten, Termine direkt während des Gesprächs zu buchen. Das ist besonders nützlich für Vertrieb, Support, Onboarding, Buchungen und jeden Ablauf, bei dem das Sichern eines Termins während des Anrufs Reibung reduziert und Schwung erhält. ### Terminanbieter Bevor Sie **Terminplanung** aktivieren, verbinden Sie den Terminanbieter, den Sie verwenden möchten. Sie können mit **Google Calendar** oder **Cal.com** arbeiten. Sobald das Konto verbunden ist, können Sie den Kalender oder die Buchungskonfiguration auswählen, die der Agent verwenden soll. **Google Calendar** ist die richtige Wahl, wenn Sie direkt in verbundenen Google-Kalendern planen möchten. **Cal.com** ist die richtige Wahl, wenn Ihre Buchungsabläufe bereits auf Cal.com laufen. Die Zeitzone des Agenten sollte mit der Zeitzone des Kalenders übereinstimmen, um Fehler bei Terminvorschlägen oder Verfügbarkeitsbestätigungen zu vermeiden. ### Zusammenfassungs-E-Mail nach dem Anruf **Zusammenfassungs-E-Mail nach dem Anruf** sendet automatisch eine E-Mail, wenn der Anruf endet. Diese Aktion hält Verantwortliche, Teams oder gemeinsame Postfächer informiert, ohne dass manuelle Nachverfolgung erforderlich ist. * Definieren Sie die Empfänger, die die E-Mail erhalten sollen. * Schreiben Sie eine klare Betreffzeile. * Schreiben Sie den Basistext der Nachricht. * Wählen Sie die Sprache der E-Mail. * Entscheiden Sie, ob Anrufdaten enthalten sein sollen. * Entscheiden Sie, ob extrahierte Felder enthalten sein sollen. ### Intelligentes Opt-out **Intelligentes Opt-out** gibt Anrufern eine klare und respektvolle Möglichkeit, zukünftigen Kontakt abzulehnen. Diese Aktion ist besonders nützlich in Lead-Generierungs-, Outreach- oder Follow-up-Abläufen, in denen Abmeldeanfragen korrekt behandelt werden müssen. ### Problem- und Beschwerdeverfolgung **Problem- und Beschwerdeverfolgung** ermöglicht es dem Agenten, während des Anrufs erkannte Probleme oder Beschwerden zu identifizieren und zu protokollieren. Aktivieren Sie diese Funktion, wenn ein Gespräch einen Fall erzeugen soll, den Ihr Team anschließend prüfen, verwalten oder eskalieren kann. ### Datensynchronisierung (Post-Call-Webhook) **Datensynchronisierung** sendet erfasste Anrufdaten automatisch an ein anderes System, sobald das Gespräch endet. Das ist die richtige Option, wenn Sie mit CRM-Systemen, Automatisierungen, operativen Integrationen oder internen Systemen arbeiten, die die Daten ohne manuelles Eingreifen benötigen. Geben Sie die Webhook-URL ein, die die Daten empfangen soll, und prüfen Sie im Voraus, welches System diese Informationen erhält und wie sie dort verarbeitet werden. ### Informationserfassung (Datenextraktion) **Informationserfassung** verwandelt das Gespräch in strukturierte Daten. Sie können definieren, welche Informationen das System während des Anrufs automatisch erkennen soll, etwa Namen, Daten, Präferenzen, Städte, Produkte von Interesse oder Kontaktgründe. ### Entität hinzufügen **Entität hinzufügen** ermöglicht es Ihnen, eine neue Entität zu erstellen, um eine bestimmte Information zu erfassen. Jede Entität definiert, was extrahiert werden soll und wie es gespeichert wird. * **Datentyp** definiert die Art des Werts, den Sie erfassen möchten. * **Bezeichner** ist der interne Name, der zum Speichern dieser Entität verwendet wird. * **Beschreibung** erklärt genau, was das System extrahieren soll. * **Enum-Werte** ermöglichen es Ihnen, das Ergebnis auf eine geschlossene Liste gültiger Werte zu beschränken, wenn Sie eine konsistentere Ausgabe benötigen. ### Kontaktdaten erfassen und speichern **Kontaktdaten erfassen und speichern** speichert extrahierte Informationen direkt im Kontaktprofil. Aktivieren Sie diese Funktion, wenn Sie erfasste Daten in zukünftigen Anrufen wiederverwenden oder reichhaltigere Kontaktdatensätze pflegen möchten. ### Persistenz und Verbindung (Anrufwiederholung) **Anrufwiederholung** ermöglicht es Ihnen, automatische Wiederholungsversuche zu konfigurieren, wenn ein Anruf nicht abgeschlossen wurde. Das ist besonders nützlich für ausgehende Agenten, bei denen ein Anruf unbeantwortet bleiben oder auf einer Mailbox landen kann. * **Wiederholungsversuche** definiert, wie oft das System den Anruf erneut versuchen soll, bevor es stoppt. * **Wartezeit zwischen Versuchen** definiert, wie viele Minuten das System vor dem nächsten Versuch warten soll. ### Bewährte Vorgehensweisen Aktivieren Sie nur die Aktionen, die dem tatsächlichen Anruffluss echten Mehrwert bringen. Verbinden Sie **Google Calendar** oder **Cal.com**, bevor Sie **Terminplanung** verwenden. Verwenden Sie klare Betreffzeilen und Nachrichten in Zusammenfassungs-E-Mails. Definieren Sie jede Extraktionsentität sorgfältig. Speichern Sie Kontaktdaten nur dann, wenn sie später nützlich sind. Prüfen Sie den Webhook, bevor Sie **Datensynchronisierung** aktivieren. Legen Sie die Wiederholungsfrequenz passend zu Ihrem Betrieb fest. Stimmen Sie die Zeitzone des Agenten immer mit der Zeitzone des Kalenders ab. > **Wichtig:** Automatisierungen sollten manuelle Arbeit reduzieren und nicht später zusätzlichen Bereinigungsaufwand erzeugen. Behalten Sie nur die Aktionen bei, die Ihr Team tatsächlich nutzen wird. ## Abschnitt 6: Website-WidgetScreenshot: der Tab Website-Widget, in dem Sie das öffentliche Widget vorbereiten, den Einbettungscode kopieren und das Besuchererlebnis anpassen.
Das **Website-Widget** ermöglicht es Ihnen, Ihren Agenten direkt über ein eingebettetes Widget auf einer Webseite zu veröffentlichen. Dieser Bereich hilft Ihnen, Ihren Agenten außerhalb von Callin verfügbar zu machen und ihn über Ihre Website, Landingpage, Support-Seite, Ihr Kundenportal oder jede andere Seite zugänglich zu machen, auf der Sie Sprache, Chat oder beides anbieten möchten. Das **Website-Widget** kombiniert zwei Arten von Setup: die technische Integration des Widgets auf Ihrer Website und die visuelle sowie textliche Anpassung des Erlebnisses. ### Was Sie im Website-Widget tun können In diesem Bereich können Sie das Integrations-Snippet des Widgets kopieren, wählen, ob das Widget eingebettet oder als schwebender Starter erscheint, das Widget-Thema auswählen, festlegen, ob die Interaktion per Sprache, Chat oder beidem erfolgt, die visuelle Größe des Dials anpassen, Echtzeit-Transkription aktivieren oder deaktivieren, die Stummschaltfläche ein- oder ausblenden, Farben anpassen und den sichtbaren Text des Widgets bearbeiten. ### Einbettungssnippet Das **Einbettungssnippet** ist der Block, mit dem Sie das Widget in Ihre Website integrieren. Hier erhalten Sie den Ausschnitt, der in das HTML der Seite kopiert und eingefügt werden muss, auf der der Agent erscheinen soll. Die Schaltfläche **Kopieren** kopiert das Snippet, damit Sie es direkt in Ihre Website einfügen können. ### Wo das Snippet platziert werden soll Fügen Sie das Snippet in den Teil des HTMLs ein, an dem das Widget erscheinen soll. Wenn der gewählte Modus **Inline-Einbettung** ist, platzieren Sie es genau dort, wo das Widget gerendert werden soll. Wenn der gewählte Modus **Schwebender Starter** ist, platzieren Sie es nahe dem Ende des Seiteninhalts, damit es als schwebender Einstiegspunkt funktioniert. ### Layout und Verhalten **Layout und Verhalten** steuert, wie das Widget eingebettet wird und wie Besucher damit interagieren. ### Widget-Modus Der **Widget-Modus** definiert, wie das Widget auf Ihrer Website erscheint. Die verfügbaren Optionen sind **Inline-Einbettung** und **Schwebender Starter**. * **Inline-Einbettung** rendert das vollständige Widget direkt in der Seite, genau an der Stelle, an der Sie das Snippet platzieren. * **Schwebender Starter** zeigt einen schwebenden Einstiegspunkt, der das Widget öffnet, wenn der Besucher darauf klickt. ### Thema des eingebetteten Widgets Das **Thema des eingebetteten Widgets** steuert das gesamte visuelle Thema des öffentlichen Widgets. Die verfügbaren Optionen sind **App-Thema übernehmen**, **Hell** und **Dunkel**. Wählen Sie das Thema passend zum tatsächlichen Design Ihrer Website. Lesbarkeit und Markenkonsistenz sollten immer an erster Stelle stehen. ### Gesprächsmodus Der **Gesprächsmodus** definiert, wie Besucher mit dem Widget interagieren können. Die verfügbaren Optionen sind **Nur Sprache**, **Nur Chat** und **Sprache + Chat**. * **Nur Sprache** beschränkt die Interaktion auf Sprache. * **Nur Chat** beschränkt die Interaktion auf Text. * **Sprache + Chat** ermöglicht Nutzern die Interaktion sowohl per Sprache als auch per Chat. ### Darstellung Die **Darstellung** steuert den visuellen Stil des Widget-Dials und des Starters. ### Widget-Variante und Dial-Größe Die **Widget-Variante** definiert die grundlegende visuelle Größe des Widgets. Die verfügbaren Optionen sind **Sehr klein**, **Kompakt** und **Voll**. Die **Dial-Größe** erlaubt es Ihnen, die minimale und maximale Größe des Dials in Pixeln festzulegen. ### Echtzeit-Transkription und Stummschaltfläche Die **Echtzeit-Transkription** steuert, ob das Widget während des laufenden Gesprächs eine Live-Transkription anzeigt. **Stummschaltfläche anzeigen** steuert, ob das Widget eine Schaltfläche zum Stummschalten und Aktivieren des Mikrofons während des Anrufs anzeigt. ### Orb-Farben **Primärfarbe des Orbs** und **Sekundärfarbe des Orbs** definieren die Hauptfarben des Widgets. Verwenden Sie Farben, die zu Ihrer Marke passen und genügend Kontrast bieten, damit Lesbarkeit und ein sauberes visuelles Erlebnis erhalten bleiben. ### Dial-Beschriftungen **Dial-Beschriftungen** ermöglichen es Ihnen, den Text anzupassen, der je nach Interaktionsstatus in der Mitte des Dials angezeigt wird. * **Mitte inaktiv** * **Mitte verbindet** * **Mitte hört zu** * **Mitte Unterbrechung** ### Textbeschriftungen **Textbeschriftungen** ermöglichen es Ihnen, verschiedene allgemeine Texte der Benutzeroberfläche anzupassen. * **Hauptbeschriftung** * **Anruf starten** * **Chat starten** * **Anruf beenden** * **Chat-Status** * **Platzhalter für eine neue Unterhaltung** ### Chat-Oberflächenbeschriftungen **Chat-Oberflächenbeschriftungen** ermöglichen es Ihnen, die spezifischen Texte des Chat-Erlebnisses anzupassen. * **Beschriftung Sprach-Tab** * **Beschriftung Chat-Tab** * **Chat-Titel** * **Chat-Untertitel** * **Chat-Status inaktiv, verbindend und live** * **Beschriftung Chat starten** * **Beschriftung Chat beenden** * **Leerer Chat-Zustand** * **Chat-Platzhalter inaktiv und aktiv** * **Beschriftung Chat senden** ### Wie Sie das Widget an Ihren Anwendungsfall anpassen Für eine kommerzielle Landingpage können **Inline-Einbettung**, ein klares oder an das App-Thema angepasstes Design, **Sprache + Chat**, eine **Voll**-Variante und kontaktorientierte Texte gut funktionieren. Für Website-Support funktionieren **Schwebender Starter**, **Nur Chat** oder **Sprache + Chat**, eine **Kompakt**-Variante und hilfeorientierte Texte oft sehr gut. Für ein sprachzentriertes Erlebnis können **Inline-Einbettung**, **Nur Sprache**, ein größeres Dial, eine sichtbare Stummschaltfläche und einfache direkte Labels sehr gut funktionieren. ### Bewährte Vorgehensweisen Wählen Sie den Widget-Modus entsprechend dem verfügbaren Platz auf Ihrer Website. Passen Sie das Thema an das tatsächliche Webdesign an. Verwenden Sie einen Gesprächsmodus, der zum erwarteten Nutzerverhalten passt. Prüfen Sie die Dial-Größe auf Desktop und Mobilgeräten. Aktivieren Sie die Echtzeit-Transkription, wenn Sie eine stärkere Unterstützung für Barrierefreiheit wünschen. Passen Sie Farben an, ohne die Lesbarkeit zu beeinträchtigen. Verwenden Sie klare, kurze und markenkonsistente Beschriftungen. Testen Sie das Widget immer auf einer echten Seite, bevor Sie veröffentlichen. > **Tipp:** Testen Sie das Widget vor der Veröffentlichung auf der echten Seite, auf der es eingebunden wird. Größe, Farben und Beschriftungen wirken außerhalb des Editors oft anders. ## Abschnitt 7: ErweitertScreenshot: der Tab Erweitert, in dem Sie Zuhören, Umgang mit Stille, Datenschutz und Telefonieleistung fein abstimmen.
Der Tab **Erweitert** bündelt die Feineinstellungen des Agenten. Hier konfigurieren Sie, wie der Agent zuhört, wie er Gespräche interpretiert, wie er mit Stille umgeht, wie er Anrufdaten behandelt und wie er die Leistung in ausgehenden Telefonszenarien optimiert. Dieser Bereich wird besonders wichtig, wenn Sie das Verhalten des Agenten präziser abstimmen möchten. **Erweitert** ist in vier Hauptblöcke unterteilt: **Stimme und Verständnis**, **Gesprächsfluss**, **Datenschutz und Daten** und **Telefonie-Extras**. ### Stimme und Verständnis **Stimme und Verständnis** ermöglicht es Ihnen, anzupassen, wie der Agent Audio erfasst und wie bestimmte Begriffe während eines Gesprächs priorisiert werden. Dieser Block ist besonders nützlich, wenn der Agent mit bestimmten Wörtern, Namen, Marken, Fachbegriffen, Zahlen oder Vokabular arbeitet, die genauer erkannt werden sollen. ### Qualität der Spracherfassung Die **Qualität der Spracherfassung** definiert das Audioformat, das der Agent zur Verarbeitung von Sprache verwendet. Die verfügbaren Optionen umfassen **PCM 8000 Hz**, **PCM 16000 Hz**, **PCM 22050 Hz**, **PCM 24000 Hz**, **PCM 44100 Hz**, **PCM 48000 Hz** und **ulaw 8000 Hz**. **PCM 16000 Hz** erscheint als empfohlene Option. **ulaw 8000 Hz** ist für Telefonszenarien ausgelegt. **PCM 16000 Hz** ist für die meisten Setups der beste Ausgangspunkt. ### Priorisierte Schlüsselwörter **Priorisierte Schlüsselwörter** ermöglichen es Ihnen, Begriffe hinzuzufügen, die das System bevorzugt behandeln soll, um die Erkennungsgenauigkeit zu verbessern. Dieses Feld hilft dem Agenten, wichtige Wörter zuverlässiger zu erkennen, zum Beispiel Marken, Firmennamen, Produktnamen, branchenspezifische Begriffe, Akronyme, Codes, ungewöhnliche Nachnamen oder internes Vokabular. ### Gesprächsfluss Der **Gesprächsfluss** steuert den Gesprächsrhythmus des Agenten. Dieser Block wird verwendet, um anzupassen, wie schnell der Agent in das Gespräch einsteigt, wie lange er vor einer Antwort wartet, wie er sich verhält, wenn jemand langsam buchstabiert, und wann er einen Anruf nach Stille beenden soll. ### Reaktionsgrad Der **Reaktionsgrad** steuert, wie schnell der Agent in das Gespräch einsteigt, nachdem der Anrufer aufgehört hat zu sprechen. Die verfügbaren Optionen sind **Geduldig**, **Normal** und **Eifrig**. **Geduldig** lässt den Agenten länger warten, bevor er antwortet. **Normal** bietet ein Gleichgewicht zwischen Geschwindigkeit und Natürlichkeit. **Eifrig** lässt den Agenten schneller antworten. ### Buchstabiergeduld Die **Buchstabiergeduld** macht den Agenten geduldiger, wenn ein Anrufer Namen, E-Mail-Adressen oder Identifikationsnummern langsam buchstabiert. Die verfügbaren Optionen sind **Auto** und **Aus**. **Auto** ist die empfohlene Option, wenn der Agent Informationen sammeln muss, die oft buchstabiert oder langsam gesprochen werden. ### Gesprächszug nach Stille übernehmen **Gesprächszug nach Stille übernehmen** definiert, wie viele Sekunden der Agent warten soll, nachdem der Anrufer aufgehört hat zu sprechen, bevor er seinen Einsatz übernimmt. ### Gespräch nach Stille beenden **Gespräch nach Stille beenden** definiert die Dauer der Stille, nach der der Anruf automatisch beendet wird, wenn der Anrufer nicht mehr antwortet. ### Maximale Gesprächsdauer Die **Maximale Gesprächsdauer** definiert die maximal zulässige Länge eines einzelnen Anrufs. ### Datenschutz und Daten **Datenschutz und Daten** steuert, wie Anrufdaten verarbeitet werden, und hilft Ihnen, operative Qualität, interne Überprüfung, Datenschutz und Compliance auszubalancieren. ### Anrufe aufzeichnen **Anrufe aufzeichnen** erlaubt es dem System, Gesprächstranskripte und Audio sicher zu speichern. Aktivieren Sie diese Option nur, wenn sie mit Ihren internen Richtlinien für Datenschutz, Speicherung und Compliance übereinstimmt. ### Telefonie-Extras **Telefonie-Extras** bündeln telefonspezifische Einstellungen, insbesondere solche, die auf die Verbesserung der Leistung bei ausgehenden Anrufen ausgerichtet sind. ### Nummernrotation Die **Nummernrotation** rotiert automatisch zwischen den verfügbaren Telefonnummern. Das hilft, das Risiko zu verringern, dass eine Nummer als Spam markiert wird, verteilt das Anrufvolumen auf mehrere Nummern, verbessert die Zustellbarkeit und macht ausgehende Abläufe widerstandsfähiger. ### Telefonnummern auswählen und Anrufe pro Nummer **Telefonnummern auswählen** ermöglicht es Ihnen, festzulegen, welche Nummern an der Rotation teilnehmen. Wenn die **Nummernrotation** aktiviert ist, muss mindestens eine Nummer ausgewählt sein. **Anrufe pro Nummer** definiert, wie viele Anrufe das System von einer Nummer aus tätigt, bevor es zur nächsten Nummer in der Rotation wechselt. ### Bundesstaatenbasierte Einschränkung Die **Bundesstaatenbasierte Einschränkung** begrenzt Anrufe so, dass der Agent mit einer lokalen Nummer aus demselben Bundesstaat wie der Kontakt wählt. Diese Funktion ist für US-Ortsnummern ausgelegt und erfordert kompatible lokale Nummern im Konto. ### Bewährte Vorgehensweisen Verwenden Sie **PCM 16000 Hz** als Ausgangspunkt. Fügen Sie **Priorisierte Schlüsselwörter** nur für wirklich wichtige Begriffe hinzu. Belassen Sie den **Reaktionsgrad** auf **Normal**, es sei denn, der Anwendungsfall erfordert eindeutig einen anderen Rhythmus. Aktivieren Sie **Buchstabiergeduld**, wenn der Agent sensible oder buchstabierte Daten sammelt. Prüfen Sie die Stille-Einstellungen sorgfältig. Verwenden Sie **Anrufe aufzeichnen** nur, wenn es zu Ihren internen Richtlinien passt. Aktivieren Sie die **Nummernrotation** nur, wenn Sie tatsächlich mehrere nützliche Nummern zur Verfügung haben. Bestätigen Sie, dass die **Bundesstaatenbasierte Einschränkung** in Ihrem Konto wirklich unterstützt wird, bevor Sie sie aktivieren. > **Wichtig:** Erweiterte Einstellungen sind am nützlichsten, wenn Sie sie aus einem klaren Grund ändern und das Ergebnis mit echten Anrufen testen. # Agents IA Source: https://support.callin.io/Create-AI-Agent/Create-Agent-Enchanced-copied-2 Comment fonctionne la page de création d'agents dans Callin.io et ce que fait chacune de ses sept sections. [Ouvrir la page des Agents IA dans Callin.io](https://app.callin.io/agents) La page **Agents IA** est l'endroit où tu construis et configures les agents qui prennent en charge tes appels téléphoniques et les conversations de ton site web. Chaque agent a sa propre configuration, divisée en sept sections accessibles depuis les onglets en haut : **Agent**, **Flux de travail**, **Base de connaissances**, **Outils**, **Action d'appel**, **Widget pour site web** et **Avancé**. Cette page t'explique ce que fait chaque section et ce que tu peux y configurer.Capture : la page de création d'agent. Chaque onglet en haut ouvre une partie différente de la configuration de l'agent.
> **Astuce :** La première fois, parcours les onglets dans l'ordre. Chacun s'appuie sur le précédent, et une configuration propre est beaucoup plus simple à tester et à maintenir ensuite. ## Section 1 : Agent L'onglet **Agent** est l'endroit où tu définis l'identité et le comportement principaux de l'assistant : comment il doit parler, quelle voix et quelle langue il utilise, quel modèle d'IA l'alimente, et s'il répond aux appels entrants, en passe des sortants ou les deux. Une bonne configuration ici fait que tout le reste fonctionne mieux. Une configuration faible crée des problèmes que ni le flux ni les outils ne pourront corriger ensuite.Capture : l'onglet Agent, où tu configures le prompt, la voix, la langue, le modèle et la direction d'appel.
### Prompt de conversation Le **Prompt de conversation** est l'ensemble principal d'instructions que ton agent suit pendant un appel. Considère-le comme le manuel de l'agent : qui il est, dans quel contexte il travaille, quel ton il doit adopter et quelles règles il doit respecter. Le modèle de prompt comprend déjà trois sections de base que tu dois remplir : * **Personnalité** — qui est l'agent et quel rôle il joue. * **Environnement** — le contexte dans lequel il travaille (appel d'assistance, prise de rendez-vous, accueil, etc.). * **Ton** — comment il doit sonner (calme, chaleureux, professionnel, concis). Après ces trois sections, ajoute des règles opérationnelles qui guident les décisions de l'agent pendant l'appel. Quelques règles qui fonctionnent bien dans la plupart des configurations : * Poser une seule question de clarification par tour. * Toujours amener l'utilisateur à l'étape utile suivante. * S'appuyer sur la base de connaissances pour répondre. * Garder les réponses courtes, sauf si l'utilisateur demande plus de détails. * Ne pas inventer de réponses. Si l'information n'est pas claire, le dire. > **Astuce :** Écris le prompt comme si tu donnais des instructions à un nouvel employé lors de son premier jour. Opérationnel et clair, pas décoratif. ### Ajouter des variables et variables dynamiques Le bouton **Ajouter des variables**, sous l'éditeur du prompt, te permet d'insérer des marqueurs dans le texte — par exemple le nom de l'agent, l'entreprise, la ville ou un service. Tu peux utiliser des variables système, des variables personnalisées ou créer une nouvelle variable à la volée. Quand tu crées une nouvelle variable, elle apparaît comme puce sous l'éditeur et s'ajoute au panneau **Variables dynamiques**, plus bas, où tu lui assignes sa valeur réelle. C'est la bonne approche quand tu veux réutiliser le même agent pour différentes marques, sites ou services sans réécrire le prompt à chaque fois. ### Fuseau horaire Juste à côté de l'éditeur du prompt, il y a un sélecteur de fuseau horaire (par exemple, **Madrid (GMT+1)**). C'est la référence horaire que l'agent utilise quand il parle d'*aujourd'hui*, *demain*, *cet après-midi* ou de tout moment précis pendant l'appel. Choisis toujours le fuseau réel de l'activité que représente l'agent. Un fuseau mal choisi conduit à confirmer des rendez-vous à la mauvaise heure. ### Personnalité par défaut La **Personnalité par défaut** est un préréglage de comportement qui complète ton prompt. Vérifie-la en même temps que le prompt pour que le ton final corresponde réellement à ce que tu veux faire entendre à tes appelants. ### Message d'accueil Le **Message d'accueil** est la première chose que l'agent dit au démarrage de l'appel. Un bon accueil indique à l'appelant à qui il parle et quel type d'aide il peut recevoir, en une seule phrase courte. Quelques exemples : * Assistance : « Bonjour, je suis l'assistant d'assistance. Dis-moi ce qui se passe et je t'aide étape par étape. » * Rendez-vous : « Bonjour, je suis l'assistant de réservation. Je peux t'aider à prendre, modifier ou annuler un rendez-vous. » * Accueil : « Bonjour, merci de ton appel. Je suis l'assistant virtuel et je t'aiderai avec ta demande. » ### Autoriser les interruptions Quand **Autoriser les interruptions** est activé, l'appelant peut parler par-dessus l'agent et celui-ci s'arrête pour écouter. Cela rend la conversation plus naturelle et c'est généralement un bon réglage par défaut pour l'assistance, l'accueil et la plupart des flux de service client. > **Erreur fréquente :** Désactiver les interruptions alors que ton message d'accueil contient une information critique que l'appelant doit entendre en entier. Si ce n'est pas ton cas, laisse-les activées. ### Voix **Voix** contrôle la façon dont sonne ton agent. La voix ne change pas *ce que* l'agent dit, mais elle influence beaucoup le ressenti de l'appel — clarté, confiance et impression générale. Le panneau de sélection de voix comporte trois onglets : * **Explorer** — le catalogue de voix disponibles, avec filtres par langue et par genre, et une courte description pour chacune. * **Clonées** — voix que tu as clonées ou importées dans ton compte. * **Ajouter** — importe une voix depuis ElevenLabs en collant un lien partagé. Tu peux aussi utiliser **Ajouter une voix supplémentaire** pour ajouter des voix secondaires, utile quand un agent doit gérer plusieurs langues ou différents segments de clientèle. Chaque voix a ses propres réglages : * **Mode expressif** — à quel point la voix est expressive. * **Vitesse** — la vitesse à laquelle elle parle. * **Stabilité** — équilibre entre expressivité et cohérence. * **Similarité** — à quel point elle préserve son identité vocale d'origine. ### Réglages communs de la voix Sous la liste des voix, il y a deux contrôles audio globaux : * **Format de sortie TTS** — format de l'audio généré. **PCM 16000 Hz** est l'option recommandée pour la plupart des cas car elle offre un bon équilibre entre qualité audio et vitesse de traitement. * **Optimiser la latence du streaming** — contrôle l'équilibre entre le temps que met l'agent à commencer à parler et la qualité de l'audio. Plus d'optimisation signifie un démarrage plus rapide mais une qualité légèrement moindre. ### Langue **Langue** définit la langue par défaut de l'agent et les langues supplémentaires vers lesquelles il peut basculer en cours de conversation. N'active que les langues dont tu as réellement besoin. Ajouter des langues « au cas où » a tendance à rendre le comportement moins prévisible. ### Intelligence IA (LLM) L'**Intelligence IA (LLM)** est le modèle de langage qui anime l'agent. Un **LLM** (Large Language Model, grand modèle de langage) est ce qui comprend l'appelant, suit les règles du prompt, utilise la base de connaissances et génère chaque réponse. Le modèle a un impact direct sur trois choses : * À quel point l'agent comprend ce que l'appelant veut dire. * À quelle vitesse il répond (tu verras une latence approximative à côté de chaque modèle, par exemple *\~179ms*). * À quel point il reste cohérent sur les longues conversations. Les modèles disponibles incluent **Neuron 1.0**, **GPT-OSS 120B**, **GLM-4.5 Air**, **GPT-4.1 Nano**, **GPT-5 Nano**, **Gemini 2.5 Flash Lite**, **Gemini 2.5 Flash** et **Claude Haiku 4.5**. Pour les agents dédiés aux rendez-vous et à la prise de réservation, **Gemini 2.5** est un choix pratique et solide. ### Température La **Température** contrôle la quantité de variation que l'agent ajoute à ses réponses. Une température basse produit des réponses plus stables et prévisibles. Une température haute introduit plus de variation et moins de contrôle. Pour les agents d'assistance, de rendez-vous et opérationnels, garde la température basse. Réserve les températures plus élevées aux usages créatifs ou exploratoires. ### Direction de l'appel La **Direction de l'appel** décide comment l'agent participe au flux d'appels : * **Entrants** — l'agent répond aux appels reçus (assistance, accueil, service client). * **Sortants** — l'agent passe des appels (campagnes, rappels, confirmations, suivis). * **Les deux** — le même agent travaille en entrants et en sortants. ### Enregistrer et valider **Enregistrer** sauvegarde la configuration actuelle. **Effacer** annule les modifications non enregistrées. Après chaque changement important, fais un appel test réel et vérifie le message d'accueil, la voix, les langues actives, le modèle choisi et les valeurs des variables dynamiques. > **Important :** Une bonne configuration d'agent doit sonner juste lors d'un appel réel, pas seulement avoir l'air correcte dans l'éditeur. ## Section 2 : Flux de travail L'onglet **Flux de travail** est l'endroit où tu décides comment se déplace la conversation. Alors que l'onglet **Agent** définit qui est l'assistant, **Flux de travail** définit le chemin que suit l'appel : branches selon ce que veut l'appelant, transferts, appels d'outils et clôtures propres. Tu le construis sur un canevas visuel en plaçant des nœuds et en les reliant entre eux.Capture : le canevas du flux de travail, où tu dessines les chemins de la conversation du début à la fin.
### Ce que tu peux construire ici À partir d'un point d'entrée unique, tu peux : * Créer plusieurs chemins au sein d'une même conversation. * Envoyer l'appel à un **Sous-agent** pour une étape spécialisée. * Transférer l'appel à un autre agent. * Transférer l'appel à un numéro de téléphone. * Exécuter un outil déjà existant. * Clore la conversation avec un nœud **Fin**. * Contrôler quel chemin s'applique avec des conditions de type **Condition LLM**. ### Début **Début** est le point d'entrée. Toute conversation commence ici. Ce nœud ne parle pas et n'agit pas par lui-même — il lance simplement le chemin et envoie l'appel au nœud suivant. Le panneau latéral du nœud **Début** comporte deux onglets : * **Aperçu** — explique son rôle. * **Connexions** — liste tous les chemins partant du nœud, avec leur étiquette et leur destination. ### Transitions et conditions LLM Une transition est la ligne qui relie un nœud au suivant. Chaque transition a une étiquette visible et une **Condition LLM** — un court texte qui indique au modèle quand ce chemin doit s'appliquer. Exemples de conditions : * « Utiliser ce chemin lorsque l'utilisateur a besoin d'une aide technique avec la plateforme. » * « Utiliser ce chemin lorsque l'utilisateur demande à parler à une personne. » * « Utiliser ce chemin lorsque le problème est résolu et que la conversation doit se terminer. » Les réglages opérationnels des transitions se trouvent dans l'onglet **Suivant**. ### Compléter la configuration du flux Le panneau **Compléter la configuration du flux** te dit exactement ce qu'il manque pour pouvoir enregistrer le flux correctement. Il est très utile dans les flux importants car il pointe le nœud ou la connexion précis qui ont encore besoin d'attention. Avertissements typiques : * Un nœud **Transfert vers un agent** sans agent de destination. * Un nœud **Outil** sans outil sélectionné. * Une transition sans texte de condition. * Un nœud ou une branche encore incomplets. ### Sous-agent Un **Sous-agent** est une étape spécialisée à l'intérieur du même flux de travail. Utilise-le quand une partie de la conversation a besoin de son propre objectif, voix, modèle ou comportement, différent de ceux de l'agent principal. À l'intérieur d'un nœud de Sous-agent, tu peux configurer : * **Général** — prompt système, prompt de remplacement, voix, LLM, prédisposition et patience à l'épellation. * **Base de connaissances** — active **Hériter de la base de connaissances** pour utiliser celle de l'agent principal, ou affecte-en une autre. * **Outils** — active **Hériter des outils personnalisés** ou ajoute des outils précis avec **Ajouter un outil**. Les outils ne se créent pas ici. Ils sont créés dans la section **Outils** et, depuis le flux, on ne fait que les sélectionner ou les hériter. ### Nœud d'outil Le nœud **Outil** envoie la conversation à une étape où l'agent utilise un outil déjà existant. Ce nœud ne crée pas de nouveaux outils — il ne fait que relier le flux à un outil déjà configuré. ### Transfert vers un agent Le **Transfert vers un agent** confie la conversation à un autre agent de ton compte. Utilise-le lorsque l'appel doit passer à un assistant spécialisé dans une autre tâche, une autre langue ou un autre flux. Tu peux configurer : * L'agent de destination. * Un délai en millisecondes avant le transfert. * Un message de transfert et s'il doit être joué. Exemples de message de transfert : * « Je vais te passer à l'agent adapté à cette demande. » * « Je te mets en relation avec l'assistant spécialisé sur ce type de question. » ### Transfert vers un numéro de téléphone Le **Transfert vers un numéro de téléphone** envoie l'appel vers un numéro téléphonique. Utilise-le quand la conversation doit sortir de l'agent et continuer sur une ligne précise. Le type de destination peut être : * **Numéro de téléphone** — un numéro fixe, idéal pour l'accueil, une ligne commerciale ou une ligne d'assistance dédiée. * **Variable dynamique de téléphone** — la destination est décidée à l'exécution selon le contexte de la conversation. ### Fin Le nœud **Fin** clôt la conversation. Quand le chemin l'atteint, l'appel se termine. Utilise-le quand : * Le sujet est totalement résolu. * Une branche doit se fermer proprement. * Une étape est terminée et ne doit pas se prolonger. ### Dupliquer et supprimer Chaque nœud dispose de commandes pour le dupliquer ou le supprimer. **Dupliquer** aide à monter plus rapidement des branches similaires. Avant de supprimer un nœud, vérifie les transitions qui y sont reliées pour ne pas casser un # Agentes de IA Source: https://support.callin.io/Create-AI-Agent/Create-Agent-Enchanced-copied-3 Cómo funciona la página de creación de agentes en Callin.io y qué hace cada una de sus siete secciones. [Abrir la página de Agentes de IA en Callin.io](https://app.callin.io/agents) La página de **Agentes de IA** es donde construyes y configuras los agentes que atienden tus llamadas de teléfono y las conversaciones de tu sitio web. Cada agente tiene su propia configuración, dividida en siete secciones a las que accedes desde las pestañas de arriba: **Agente**, **Flujo de trabajo**, **Base de conocimiento**, **Herramientas**, **Acción de llamada**, **Widget para sitio web** y **Avanzado**. Esta página te explica qué hace cada sección y qué puedes configurar dentro de cada una.Captura: la página de creación de agente. Cada pestaña de arriba abre una parte distinta de la configuración del agente.
> **Consejo:** La primera vez recorre las pestañas en orden. Cada una se apoya en la anterior, y una configuración limpia es mucho más fácil de probar y mantener después. ## Sección 1: Agente La pestaña **Agente** es donde defines la identidad y el comportamiento principales del asistente: cómo debe hablar, qué voz e idioma usa, qué modelo de IA lo impulsa y si responde llamadas entrantes, hace salientes o ambas. Una buena configuración aquí hace que todo lo demás funcione mejor. Una configuración floja crea problemas que ni el flujo ni las herramientas pueden arreglar después.Captura: la pestaña Agente, donde configuras el prompt, la voz, el idioma, el modelo y la dirección de llamada.
### Prompt de conversación El **Prompt de conversación** es el conjunto principal de instrucciones que sigue tu agente durante una llamada. Piénsalo como el manual del agente: quién es, en qué contexto trabaja, qué tono debe usar y qué reglas tiene que respetar. La plantilla del prompt ya incluye tres secciones base que debes rellenar: * **Personalidad** — quién es el agente y qué rol cumple. * **Entorno** — el contexto en el que trabaja (llamada de soporte, reserva de citas, recepción, etc.). * **Tono** — cómo debe sonar (calmado, cercano, profesional, breve). Después de esas tres, añade reglas operativas que guíen las decisiones del agente durante la llamada. Algunas que funcionan bien en la mayoría de configuraciones: * Hacer una sola pregunta de aclaración por turno. * Llevar siempre al usuario al siguiente paso útil. * Apoyarse en la base de conocimiento para responder. * Mantener las respuestas cortas salvo que el usuario pida más detalle. * No inventar respuestas. Si la información no está clara, decirlo. > **Consejo:** Escribe el prompt como si estuvieras dando instrucciones a un empleado nuevo en su primer día. Operativo y claro, no decorativo. ### Agregar variables y variables dinámicas El botón **Agregar variables**, debajo del editor del prompt, te permite insertar marcadores en el texto — por ejemplo, el nombre del agente, la empresa, la ciudad o un servicio. Puedes usar variables del sistema, variables personalizadas o crear una variable nueva al vuelo. Cuando creas una variable nueva, aparece como chip debajo del editor y se añade al panel de **Variables dinámicas**, más abajo, donde le asignas su valor real. Es lo correcto cuando quieres reutilizar el mismo agente para distintas marcas, ubicaciones o servicios sin reescribir el prompt cada vez. ### Zona horaria Justo al lado del editor del prompt hay un selector de zona horaria (por ejemplo, **Madrid (GMT+1)**). Es la referencia horaria que usa el agente cuando habla de *hoy*, *mañana*, *esta tarde* o cualquier momento concreto durante la llamada. Pon siempre la zona horaria real del negocio que representa el agente. Una zona horaria mal elegida lleva a confirmar citas a la hora equivocada. ### Personalidad por defecto La **Personalidad por defecto** es un preajuste de comportamiento que complementa tu prompt. Revísala junto con el prompt para que el tono final coincida con lo que de verdad quieres que oigan tus llamantes. ### Mensaje de bienvenida El **Mensaje de bienvenida** es lo primero que dice el agente al empezar la llamada. Una buena bienvenida le dice al llamante con quién está hablando y qué tipo de ayuda puede recibir, en una sola frase corta. Algunos ejemplos: * Soporte: "Hola, soy el asistente de soporte. Cuéntame qué pasa y te ayudo paso a paso." * Citas: "Hola, soy el asistente de reservas. Puedo ayudarte a agendar, cambiar o cancelar una cita." * Recepción: "Hola, gracias por llamar. Soy el asistente virtual y te ayudaré con tu petición." ### Permitir interrupciones Cuando **Permitir interrupciones** está activado, el llamante puede hablar por encima del agente y este se detiene a escuchar. Hace que la conversación se sienta natural y suele ser una buena opción por defecto para soporte, recepción y la mayoría de flujos de atención al cliente. > **Error común:** Desactivar las interrupciones cuando tu mensaje de bienvenida incluye información crítica que el llamante tiene que oír entera. Si no es tu caso, déjalas activadas. ### Voz **Voz** controla cómo suena tu agente. La voz no cambia *lo que* dice, pero sí afecta mucho a cómo se siente la llamada — claridad, confianza e impresión general. El panel de selección de voz tiene tres pestañas: * **Explorar** — el catálogo de voces disponibles, con filtros de idioma y género y una breve descripción de cada una. * **Clonadas** — voces que has clonado o importado en tu cuenta. * **Añadir** — importa una voz desde ElevenLabs pegando un enlace compartido. También puedes usar **Añadir voz adicional** para sumar voces secundarias, útil cuando un agente tiene que manejar varios idiomas o segmentos distintos de clientes. Cada voz tiene sus propios ajustes: * **Modo expresivo** — qué tan expresiva suena. * **Velocidad** — qué tan rápido habla. * **Estabilidad** — equilibrio entre expresividad y consistencia. * **Similitud** — cuánto preserva su identidad vocal original. ### Ajustes comunes de voz Debajo de la lista de voces hay dos controles globales de audio: * **Formato de salida TTS** — formato del audio generado. **PCM 16000 Hz** es la opción recomendada para la mayoría de casos porque ofrece un buen equilibrio entre calidad de audio y velocidad de procesamiento. * **Optimizar latencia de streaming** — controla el equilibrio entre cuánto tarda el agente en empezar a hablar y la calidad del audio. Más optimización significa empezar antes pero con un poco menos de calidad. ### Idioma **Idioma** define el idioma por defecto del agente y los idiomas adicionales a los que puede cambiar a mitad de conversación. Activa solo los idiomas que de verdad necesitas. Añadir idiomas "por si acaso" tiende a hacer el comportamiento menos predecible. ### Inteligencia de IA (LLM) La **Inteligencia de IA (LLM)** es el modelo de lenguaje que mueve al agente. Un **LLM** (Large Language Model, modelo de lenguaje grande) es lo que entiende al llamante, sigue las reglas del prompt, usa la base de conocimiento y genera cada respuesta. El modelo afecta directamente a tres cosas: * Cómo de bien entiende el agente lo que el llamante quiere decir. * Cómo de rápido responde (verás una latencia aproximada al lado de cada modelo, por ejemplo *\~179ms*). * Cómo de consistente se mantiene en conversaciones largas. Los modelos disponibles incluyen **Neuron 1.0**, **GPT-OSS 120B**, **GLM-4.5 Air**, **GPT-4.1 Nano**, **GPT-5 Nano**, **Gemini 2.5 Flash Lite**, **Gemini 2.5 Flash** y **Claude Haiku 4.5**. Para agentes de citas y reservas, **Gemini 2.5** es una opción práctica y sólida. ### Temperatura La **Temperatura** controla cuánta variación añade el agente a sus respuestas. Una temperatura baja produce respuestas más estables y predecibles. Una temperatura alta introduce más variación y menos control. Para agentes de soporte, citas y operativa general, mantén la temperatura baja. Reserva las temperaturas altas para casos creativos o exploratorios. ### Dirección de la llamada La **Dirección de la llamada** decide cómo participa el agente en el flujo de llamadas: * **Entrantes** — el agente atiende llamadas que recibe (soporte, recepción, atención al cliente). * **Salientes** — el agente realiza llamadas (campañas, recordatorios, confirmaciones, seguimientos). * **Ambas** — el mismo agente trabaja en entrantes y salientes. ### Guardar y validar **Guardar** almacena la configuración actual. **Limpiar** descarta los cambios sin guardar. Después de cada cambio importante, haz una llamada real de prueba y revisa la bienvenida, la voz, los idiomas activos, el modelo elegido y los valores de las variables dinámicas. > **Importante:** Una buena configuración del agente tiene que sonar bien en una llamada real, no solo verse bien en el editor. ## Sección 2: Flujo de trabajo La pestaña **Flujo de trabajo** es donde decides cómo se mueve la conversación. Mientras que la pestaña **Agente** define quién es el asistente, **Flujo de trabajo** define el camino que sigue la llamada: ramas según lo que quiera el llamante, transferencias, llamadas a herramientas y cierres limpios. Lo construyes en un lienzo visual colocando nodos y conectándolos.Captura: el lienzo del flujo de trabajo, donde dibujas las rutas de la conversación de principio a fin.
### Qué puedes construir aquí A partir de un único punto de entrada, puedes: * Crear varias rutas dentro de la misma conversación. * Enviar la llamada a un **Subagente** para una etapa especializada. * Transferir la llamada a otro agente. * Transferir la llamada a un número de teléfono. * Ejecutar una herramienta que ya exista. * Cerrar la conversación con un nodo **Fin**. * Controlar qué ruta se aplica con condiciones tipo **Condición LLM**. ### Inicio **Inicio** es el punto de entrada. Toda conversación empieza aquí. Este nodo no habla ni actúa por sí mismo — solo lanza la ruta y envía la llamada al siguiente nodo. El panel lateral del nodo **Inicio** tiene dos pestañas: * **Resumen** — explica su rol. * **Conexiones** — lista todas las rutas que salen del nodo, con su etiqueta y su destino. ### Transiciones y condiciones LLM Una transición es la línea que conecta un nodo con el siguiente. Cada transición tiene una etiqueta visible y una **Condición LLM** — un texto corto que le dice al modelo cuándo debe aplicarse esa ruta. Ejemplos de condiciones: * "Usa esta ruta cuando el usuario necesite ayuda técnica con la plataforma." * "Usa esta ruta cuando el usuario pida hablar con una persona." * "Usa esta ruta cuando el problema esté resuelto y la conversación deba terminar." Los ajustes operativos de las transiciones están en la pestaña **Adelante**. ### Completar la configuración del flujo El panel **Completar la configuración del flujo** te dice exactamente qué falta para guardar el flujo correctamente. Es muy útil en flujos grandes porque señala el nodo o la conexión exactos que aún necesitan atención. Avisos típicos: * Un nodo de **Transferencia a agente** sin agente de destino. * Un nodo de **Herramienta** sin herramienta seleccionada. * Una transición sin texto de condición. * Un nodo o rama todavía incompleto. ### Subagente Un **Subagente** es una etapa especializada dentro del mismo flujo de trabajo. Úsalo cuando una parte de la conversación necesite su propio objetivo, voz, modelo o comportamiento, distintos del agente principal. Dentro de un nodo de Subagente puedes configurar: * **General** — prompt del sistema, prompt de sustitución, voz, LLM, predisposición y paciencia al deletreo. * **Base de conocimiento** — activa **Heredar base de conocimiento** para usar la del agente principal, o asigna una distinta. * **Herramientas** — activa **Heredar herramientas personalizadas** o añade herramientas concretas con **Añadir herramienta**. Las herramientas no se crean aquí. Se crean en la sección **Herramientas** y desde el flujo solo se seleccionan o se heredan. ### Nodo de herramienta El nodo de **Herramienta** envía la conversación a una etapa donde el agente usa una herramienta ya existente. Este nodo no crea herramientas nuevas — solo conecta el flujo con una herramienta ya configurada. ### Transferencia a agente La **Transferencia a agente** entrega la conversación a otro agente de tu cuenta. Úsala cuando la llamada deba pasar a un asistente especializado en otra tarea, otro idioma u otro flujo. Puedes configurar: * El agente de destino. * Un retraso en milisegundos antes de la transferencia. * Un mensaje de transferencia y si debe reproducirse. Ejemplos de mensaje de transferencia: * "Voy a pasarte con el agente adecuado para esta consulta." * "Te conecto con el asistente especializado en este tipo de pregunta." ### Transferencia a número de teléfono La **Transferencia a número de teléfono** envía la llamada a un número telefónico. Úsala cuando la conversación tenga que salir del agente y continuar en una línea concreta. El tipo de destino puede ser: * **Número de teléfono** — un número fijo, ideal para recepción, una línea de ventas o una línea dedicada de soporte. * **Variable dinámica de teléfono** — el destino se decide en tiempo real según el contexto de la conversación. ### Fin El nodo **Fin** cierra la conversación. Cuando la ruta llega a este nodo, la llamada termina. Úsalo cuando: * El asunto esté completamente resuelto. * Una rama deba cerrarse limpiamente. * Una etapa esté completa y no deba continuar. ### Duplicar y eliminar Cada nodo tiene controles para duplicarlo o eliminarlo. **Duplicar** ayuda a montar ramas similares más rápido. Antes de eliminar, revisa las transiciones conectadas a ese nodo para no romper una ruta activa. ### Ajustes globales Los **Ajustes globales** afectan al flujo de trabajo en su conjunto. **Evitar bucles infinitos** añade una capa de seguridad que impide que la conversación quede atrapada en un bucle sin avanzar. Para desactivar un flujo sin eliminarlo, desconecta el nodo **Inicio**. Sin un Inicio conectado, el flujo no tiene punto de entrada y no se ejecuta. ### Guardar y probar **Guardar** almacena el flujo actual. **Limpiar** descarta los cambios sin guardar. El aviso de cambios sin guardar aparece cuando tienes ediciones que aún no se han guardado. > **Error común:** Un flujo puede verse completo en el lienzo y aun así fallar en la práctica. Prueba cada ruta con una conversación real antes de publicar. ## Sección 3: Base de conocimiento La pestaña **Base de conocimiento** conecta tu agente con una fuente de contenido de referencia que ya has preparado dentro de Callin.io. Así el agente tiene acceso a información detallada sin tener que meterla toda en el prompt. Úsala cuando el contenido sea demasiado largo, demasiado detallado o cambie con demasiada frecuencia para vivir dentro del prompt.Captura: la pestaña Base de conocimiento, donde vinculas una fuente de conocimiento existente al agente.
### Para qué sirve esta pestaña Esta pestaña vincula una base de conocimiento existente a un agente concreto. **No** crea contenido desde cero — eso se hace en el gestor global de bases de conocimiento. Acceso rápido: * [Abrir el gestor de bases de conocimiento](https://app.callin.io/knowledge-base) Una forma útil de pensarlo: * El **prompt** define cómo debe comportarse el agente. * La **base de conocimiento** define el contenido de referencia que el agente puede consultar al responder. ### Cuándo usar una base de conocimiento Úsala cuando el contenido sea: * Largo (manuales, políticas, documentación interna). * Cambiante con cierta frecuencia. * Ya publicado como artículos o páginas. * Mejor mantenido aparte del prompt, para facilitar las actualizaciones. Fuentes típicas: preguntas frecuentes, guías de producto, artículos de soporte, documentos de políticas, referencias internas. ### Fuentes de contenido soportadas Una base de conocimiento se puede construir desde dos tipos de fuentes: * **Archivos** — documentos subidos. * **URLs web** — páginas o documentación publicadas en línea. Eliges entre ellas dentro del panel de selección. ### Lo que ves cuando hay una base vinculada Cuando el agente ya tiene una base de conocimiento conectada, la pestaña muestra: * El nombre del grupo seleccionado. * El número de documentos vinculados. * Las acciones disponibles: **Quitar**, **Actualizar** y **Cambiar**. ### Acciones principales * **Cambiar** — abre el panel de selección para elegir otra base. * **Quitar** — desvincula la base actualmente conectada. * **Actualizar** — refresca la conexión para que el agente trabaje con la última versión de la selección vinculada. ### Panel de selección de base de conocimiento Al pulsar **Cambiar** se abre este panel. Desde aquí puedes revisar lo disponible, escoger un grupo, inspeccionar su contenido y confirmar. Lo que encuentras dentro: * **Fuente** — alterna entre **Archivos** y **URLs web**. * **Grupos** — lista de bases de conocimiento dentro de la fuente elegida. * **Refrescar** — recarga la lista de grupos. * **Documentos / URLs** — recursos que pertenecen al grupo seleccionado. * **Vinculado** — marca que indica que un recurso estará disponible para el agente al confirmar. * **Seleccionar** — confirma la elección. * **Cerrar** — sale sin cambios. ### Flujo recomendado La forma más limpia de trabajar es separar la creación de la selección: 1. Crea y organiza la base de conocimiento en el gestor global. 2. Vuelve a esta pestaña y vincula la base preparada al agente. > **Consejo:** Mantén las reglas de comportamiento en el prompt y el contenido de referencia en la Base de conocimiento. Esa separación hace que las actualizaciones sean mucho más fáciles después. ## Sección 4: Herramientas La pestaña **Herramientas** decide qué puede *hacer* tu agente durante una llamada, más allá de mantener una conversación. Mientras el prompt define cómo habla y el flujo define cómo se mueve la llamada, las herramientas le permiten ejecutar acciones en el momento adecuado. Esta pestaña hace dos cosas: te permite añadir **herramientas personalizadas** creadas por tu equipo, y activar y configurar las **herramientas del sistema** que Callin.io trae de fábrica.Captura: la pestaña Herramientas, con la sección de herramientas personalizadas arriba y las herramientas del sistema abajo.
Acceso rápido: * [Abrir la sección global de Herramientas](https://app.callin.io/tools) ### Herramientas personalizadas Las **herramientas personalizadas** son herramientas que tu equipo crea para casos específicos. No se crean dentro del agente — primero las construyes en la sección global de **Herramientas**, y luego vuelves aquí para añadirlas. Cosas típicas que puede hacer una herramienta personalizada: * Consultar un sistema externo. * Ejecutar una automatización. * Enviar o recibir datos a través de un **webhook** (una URL a la que tu herramienta llama cuando ocurre algo). * Disparar lógica específica de tu negocio. * Conectar el agente con otro servicio. Si el agente todavía no tiene herramientas personalizadas, esta zona muestra el estado vacío. El botón **Añadir herramienta** asocia una herramienta personalizada al agente. Si tu cuenta ya tiene herramientas, el selector te deja buscar y elegir una. Si no hay ninguna, te ofrece la opción directa de crear una **Herramienta tipo webhook**. ### Herramientas del sistema Las **herramientas del sistema** son herramientas integradas que cubren situaciones habituales de llamada sin que tengas que construir nada. Cada una se activa o desactiva por separado, y algunas tienen configuración adicional. #### Colgado inteligente Permite al agente cerrar la llamada limpiamente cuando detecta que la conversación ya terminó — por ejemplo, cuando el llamante se despide, confirma que el problema está resuelto o cierra claramente. Evita mantener la línea abierta más de lo necesario. #### Cambio de idioma Ayuda al agente a gestionar un cambio de idioma durante la llamada. Especialmente útil cuando el agente trabaja con varios idiomas y el llamante puede cambiar al principio o a mitad de la conversación. #### Escucha inteligente Mejora cómo escucha el agente y gestiona la conversación en tiempo real. Se controla con un único interruptor de activación. #### Transferencia a agente Entrega la conversación a otro agente de tu cuenta. Útil para mover una llamada de un agente generalista a uno especializado — por ejemplo, de un asistente general a uno de ventas o a un agente de soporte sénior. #### Transferencia a número Transfiere la llamada a un número de teléfono humano. Es una de las herramientas más importantes cuando necesitas escalar la llamada fuera del agente y entregarla a una persona — recepción, una centralita, ventas o una oficina concreta. #### Reglas de transferencia humana Definen las reglas concretas para transferir a humanos. Cada regla incluye: * **Tipo de destino** — un número fijo o un número proporcionado a través de una variable dinámica. * **Número de teléfono** o la variable dinámica de teléfono. * **Condición** — cuándo debe aplicarse esta regla. Usa un número fijo cuando el destino es siempre el mismo y una variable dinámica cuando depende del contexto de la conversación. #### Detección de buzón de voz Detecta cuándo la llamada ha caído en un buzón de voz y actúa en consecuencia. Es crítica para agentes salientes, donde muchas llamadas acaban en buzón. Tienes dos opciones: * Dejar el mensaje del buzón vacío si la llamada debe terminar al detectar el buzón. * Escribir un mensaje si quieres que el sistema lo reproduzca antes de colgar. #### Descripción y desactivar interrupción Varias herramientas del sistema incluyen dos campos extra: * **Descripción** — explica al modelo cómo y cuándo debe usarse la herramienta. * **Desactivar interrupción** — controla si la herramienta puede interrumpirse mientras se ejecuta. ### Cómo elegir las herramientas No actives todo. Elige según el caso de uso: * Un agente entrante de soporte suele usar **Colgado inteligente**, **Cambio de idioma** y **Escucha inteligente**. * Un agente que escala a humanos usa **Transferencia a número** con reglas de transferencia bien definidas. * Un agente saliente suele usar **Detección de buzón de voz**, **Colgado inteligente** y **Cambio de idioma**. > **Error común:** Activar demasiadas herramientas a la vez. Hace que el comportamiento sea más difícil de predecir, de probar y de mantener. ## Sección 5: Acción de llamada La pestaña **Acción de llamada** es donde el agente deja de ser solo una voz y empieza a producir resultados útiles: reservas, correos de seguimiento, incidencias registradas, datos estructurados y registros sincronizados. Úsala para convertir la conversación en próximos pasos concretos sobre los que tu equipo pueda actuar.Captura: la pestaña Acción de llamada, donde automatizas qué pasa durante y después de cada llamada.
Acceso rápido: * [Configurar Google Calendar](https://app.callin.io/actions/google-calendar) * [Configurar Cal.com](https://app.callin.io/actions/cal) ### Programación de citas Permite al agente reservar reuniones directamente durante la llamada. Especialmente útil en ventas, onboarding y cualquier flujo donde reservar en el momento te ahorra tener que perseguir al cliente después. Antes de activarla, conecta un proveedor de calendario: * **Google Calendar** — la mejor opción cuando quieres reservar directamente en un calendario de Google conectado. * **Cal.com** — la mejor opción cuando tu operativa de reservas ya funciona sobre Cal.com. > **Importante:** La zona horaria del agente y la del calendario deben coincidir. Si no coinciden, el agente ofrecerá o confirmará horarios incorrectos. ### Correo resumen tras la llamada Envía automáticamente un correo cuando termina la llamada, para que responsables o equipos estén al tanto sin seguimiento manual. Puedes configurar: * Los destinatarios. * El asunto. * El cuerpo base del mensaje. * El idioma del correo. * Si se incluyen los datos de la llamada. * Si se incluyen los campos extraídos (ver *Captura de información* más abajo). ### Baja inteligente de contacto Da a los llamantes una forma clara y respetuosa de decir "no me contactéis más". Importante en flujos salientes, donde las solicitudes de baja deben capturarse y respetarse de forma automática. ### Registro de incidencias y quejas Detecta incidencias o quejas durante la llamada y las registra para que tu equipo pueda revisarlas, hacer seguimiento o escalarlas. Actívalo cuando quieras que cada conversación pueda generar un caso que merezca tratarse después. ### Sincronización de datos (webhook posterior a la llamada) Envía los datos de la llamada capturados a otro sistema justo cuando termina la llamada. Es lo correcto cuando trabajas con un CRM, una plataforma de automatización o cualquier herramienta interna que necesite los datos sin copiar y pegar. Para configurarlo, indica la URL del webhook que recibirá los datos y confirma de antemano qué sistema los recibirá y cómo los procesará. ### Captura de información (extracción de datos) Convierte la conversación en datos estructurados — nombres, fechas, preferencias, ciudades, productos de interés, motivos de contacto, etc. Usa **Añadir entidad** para definir qué se debe capturar. Cada entidad tiene: * **Tipo de dato** — el tipo de valor que quieres capturar. * **Identificador** — el nombre interno con el que se almacena. * **Descripción** — exactamente qué debe extraer el sistema. * **Valores permitidos** — una lista cerrada opcional de valores válidos, cuando quieras resultados consistentes. ### Guardar datos en el contacto Cuando esto está activado, la información extraída se guarda en el perfil del contacto. Útil cuando quieres reutilizar esos datos en futuras llamadas o mantener fichas de contacto más completas. ### Reintentos de llamada Configura reintentos automáticos cuando una llamada no conecta. Se usa sobre todo en agentes salientes, donde muchas llamadas no se contestan o caen en buzón. Puedes configurar: * **Número de reintentos** — cuántas veces debe volver a intentarlo el sistema antes de rendirse. * **Tiempo de espera entre intentos** — cuántos minutos esperar entre uno y otro. > **Consejo:** Activa solo las acciones que tu equipo realmente vaya a usar. Cada automatización que enciendes es un pequeño compromiso de mantenimiento. Pocas y bien elegidas funcionan mejor que una lista larga a medio usar. ## Sección 6: Widget para sitio web La pestaña **Widget para sitio web** te permite publicar tu agente en una página web. Las visitas pueden hablar con él por voz, por chat o por ambos, directamente desde tu sitio, una landing, una página de soporte o un portal de cliente. Esta pestaña combina dos cosas: el fragmento técnico para integrar el widget y la personalización visual y textual de la experiencia.Captura: la pestaña Widget para sitio web, donde preparas el widget público y personalizas la experiencia del visitante.
### Fragmento de integración El **Fragmento de integración** es el código que copias en el HTML de tu sitio para que aparezca el widget. El botón **Copiar** lo copia al portapapeles para pegarlo directamente. Dónde pegarlo depende del modo del widget: * **Insertado en línea** — pégalo exactamente donde quieras que se renderice el widget en la página. * **Lanzador flotante** — pégalo cerca del final del cuerpo de la página para que se comporte como un punto de entrada flotante. ### Diseño y comportamiento Este bloque decide cómo se inserta el widget y cómo interactúan las visitas con él. #### Modo del widget Cómo aparece el widget en tu sitio: * **Insertado en línea** — renderiza el widget completo dentro de la página, en el lugar donde pegaste el fragmento. * **Lanzador flotante** — muestra un botón flotante que abre el widget al pulsarlo. #### Tema del widget Controla el aspecto general: * **Igual que la app** — sigue el tema que use tu sitio. * **Claro** — modo claro. * **Oscuro** — modo oscuro. Elige la opción que encaje con el diseño de tu sitio. La legibilidad y la coherencia de marca van primero. #### Modo de conversación Cómo pueden interactuar las visitas: * **Solo voz** — solo interacción por voz. * **Solo chat** — solo texto. * **Voz y chat** — ambas. ### Apariencia Controla el estilo visual del dial y el lanzador. #### Variante del widget y tamaño del dial * **Variante del widget** — tamaño visual base: **Mini**, **Compacta** o **Completa**. * **Tamaño del dial** — los valores mínimo y máximo del dial, en píxeles. #### Transcripción en tiempo real y botón de silencio * **Transcripción en tiempo real** — muestra una transcripción en vivo de la conversación mientras la llamada está en curso. * **Mostrar botón de silencio** — muestra un botón para que la visita silencie y reactive su micrófono durante la llamada. #### Colores del orbe * **Color principal del orbe** y **Color secundario del orbe** — los colores principales del widget. Usa los colores de tu marca, pero mantén suficiente contraste para que se lea bien. ### Etiquetas del dial Textos que se muestran en el centro del dial según el estado de la conversación: * **Estado en reposo** * **Conectando** * **Escuchando** * **Interrumpir** ### Etiquetas de texto Textos generales de la interfaz que puedes personalizar: * **Etiqueta principal** * **Iniciar llamada** * **Iniciar chat** * **Finalizar llamada** * **Estado de chat en curso** * **Marcador de posición de entrada para una nueva conversación** ### Etiquetas de la interfaz de chat Textos específicos de la experiencia de chat: * **Etiqueta de la pestaña de voz** * **Etiqueta de la pestaña de chat** * **Título del chat** * **Subtítulo del chat** * **Estado del chat: en reposo, conectando y en vivo** * **Etiqueta de inicio del chat** * **Etiqueta de fin del chat** * **Estado vacío del chat** * **Marcador de posición de entrada del chat: en reposo y activo** * **Etiqueta de envío del chat** ### Adaptar el widget a tu caso Algunas combinaciones que funcionan bien: * **Landing comercial** — Insertado en línea, tema claro o igual que la app, **Voz y chat**, variante **Completa**, textos orientados al contacto. * **Soporte web** — Lanzador flotante, **Solo chat** o **Voz y chat**, variante **Compacta**, textos orientados a la ayuda. * **Experiencia centrada en voz** — Insertado en línea, **Solo voz**, dial más grande, botón de silencio visible, etiquetas cortas y directas. > **Consejo:** Antes de publicar, prueba el widget en la página real donde vivirá. Tamaños, colores y textos suelen sentirse distintos fuera del editor. ## Sección 7: Avanzado La pestaña **Avanzado** es donde afinas el agente: cómo capta el audio, cómo gestiona el silencio, cómo maneja los datos de la llamada y cómo rinde en escenarios de telefonía saliente. La mayoría de agentes funcionan bien sin tocar nada aquí. Abre esta pestaña cuando quieras más precisión o cuando algo concreto no acabe de funcionar.Captura: la pestaña Avanzado, organizada en cuatro bloques para afinar el agente.
La pestaña se divide en cuatro bloques: **Voz y comprensión**, **Flujo de conversación**, **Privacidad y datos** y **Extras de telefonía**. ### Voz y comprensión Ajusta cómo capta el agente el audio y cómo prioriza determinados términos. #### Calidad de captura de voz Define el formato de audio con el que se procesa el habla. Las opciones incluyen **PCM 8000 Hz**, **PCM 16000 Hz**, **PCM 22050 Hz**, **PCM 24000 Hz**, **PCM 44100 Hz**, **PCM 48000 Hz** y **ulaw 8000 Hz**. Para la mayoría de configuraciones, déjalo en **PCM 16000 Hz**. Es el mejor equilibrio entre calidad de audio y velocidad de procesamiento. **ulaw 8000 Hz** está pensado específicamente para escenarios de telefonía. #### Palabras clave prioritarias Te permite listar términos que el agente debe priorizar al reconocer el habla. Útil para nombres de marca, productos, términos técnicos, acrónimos, códigos o apellidos poco comunes que el modelo podría malinterpretar. ### Flujo de conversación Controla el ritmo del agente: lo rápido que toma la palabra, lo paciente que es con quien habla despacio y cuándo debe colgar tras un silencio. #### Predisposición a hablar Cómo de rápido toma la palabra el agente cuando el llamante deja de hablar: * **Paciente** — espera más antes de responder. * **Normal** — equilibrado. * **Ávido** — responde rápido. **Normal** funciona bien en la mayoría de casos. #### Paciencia al deletreo Hace al agente más paciente cuando el llamante deletrea despacio — nombres, correos, números de identificación. Opciones: * **Auto** — recomendado cuando el agente suele recoger información que se deletrea. * **Desactivado** — mantiene el ritmo estándar. #### Tomar el turno tras silencio Cuántos segundos de silencio espera el agente antes de tomar la palabra. Valores bajos hacen que el agente sea más reactivo; valores altos dan más margen al llamante para pensar. #### Finalizar conversación tras silencio Cuánto tiene que durar un silencio para que la llamada termine automáticamente. Útil cuando el llamante deja de responder por completo. #### Duración máxima de la conversación Duración máxima de una llamada. Una red de seguridad que evita que las llamadas se alarguen indefinidamente. > **Consejo:** Si no tienes claro qué poner en los campos de silencio y duración, déjalos en su valor por defecto y solo ajústalos después de probar con llamadas reales. ### Privacidad y datos #### Grabación de llamadas Cuando está activada, el sistema almacena de forma segura el audio y la transcripción de las llamadas. Actívala solo si encaja con tus políticas internas de privacidad, almacenamiento y cumplimiento. ### Extras de telefonía Ajustes específicos de telefonía, sobre todo orientados a mejorar el rendimiento de las llamadas salientes. #### Rotación de números Rota automáticamente entre los números de teléfono disponibles. Ayuda a reducir el riesgo de que un número quede marcado como spam, distribuye el volumen y mejora la entregabilidad. #### Selección de números y llamadas por número * **Seleccionar números de teléfono** — elige qué números entran en la rotación. Es obligatorio elegir al menos uno cuando la **Rotación de números** está activada. * **Llamadas por número** — cuántas llamadas se hacen desde un número antes de pasar al siguiente. #### Restricción por estado Limita las llamadas para que el agente marque usando un número local del mismo estado que el contacto. Está pensado para números locales de EE. UU. — confirma que tu cuenta tiene numeración local compatible antes de activarlo. > **Importante:** Solo cambia los ajustes avanzados cuando tengas un motivo claro y puedas probar el resultado con llamadas reales. Tocar al azar aquí suele crear problemas nuevos en lugar de resolver el original. # Agenti IA Source: https://support.callin.io/Create-AI-Agent/Create-Agent-Enchanced-copied-4 Come funziona la pagina di creazione agenti in Callin.io e cosa fa ciascuna delle sue sette sezioni. [Apri la pagina degli Agenti IA in Callin.io](https://app.callin.io/agents) La pagina **Agenti IA** è il posto in cui costruisci e configuri gli agenti che gestiscono le tue chiamate telefoniche e le conversazioni del sito web. Ogni agente ha la sua configurazione, divisa in sette sezioni a cui accedi dalle schede in alto: **Agente**, **Flusso di lavoro**, **Base di conoscenza**, **Strumenti**, **Azione di chiamata**, **Widget per sito web** e **Avanzate**. Questa pagina ti spiega cosa fa ciascuna sezione e cosa puoi configurare al suo interno.Schermata: la pagina di creazione agente. Ogni scheda in alto apre una parte diversa della configurazione dell'agente.
> **Suggerimento:** La prima volta percorri le schede in ordine. Ognuna si appoggia sulla precedente e una configurazione pulita è molto più facile da testare e mantenere in seguito. ## Sezione 1: Agente La scheda **Agente** è il posto in cui definisci l'identità e il comportamento principali dell'assistente: come deve parlare, quale voce e lingua usa, quale modello di IA lo alimenta e se risponde alle chiamate in entrata, ne fa di uscita o entrambe. Una buona configurazione qui fa funzionare meglio tutto il resto. Una configurazione debole crea problemi che né il flusso né gli strumenti potranno risolvere dopo.Schermata: la scheda Agente, dove imposti il prompt, la voce, la lingua, il modello e la direzione della chiamata.
### Prompt di conversazione Il **Prompt di conversazione** è l'insieme principale di istruzioni che il tuo agente segue durante una chiamata. Pensalo come il manuale dell'agente: chi è, in quale contesto lavora, che tono deve usare e quali regole deve rispettare. Il modello del prompt include già tre sezioni di base che devi compilare: * **Personalità** — chi è l'agente e quale ruolo ricopre. * **Ambiente** — il contesto in cui opera (chiamata di supporto, prenotazione di appuntamenti, reception, ecc.). * **Tono** — come deve suonare (calmo, cordiale, professionale, sintetico). Dopo queste tre, aggiungi regole operative che guidino le decisioni dell'agente durante la chiamata. Alcune che funzionano bene nella maggior parte delle configurazioni: * Fare una sola domanda di chiarimento per turno. * Portare sempre l'utente al passo utile successivo. * Appoggiarsi alla base di conoscenza per rispondere. * Mantenere le risposte brevi, a meno che l'utente non chieda più dettagli. * Non inventare risposte. Se l'informazione non è chiara, dirlo. > **Suggerimento:** Scrivi il prompt come se stessi istruendo un nuovo dipendente al suo primo giorno. Operativo e chiaro, non decorativo. ### Aggiungi variabili e variabili dinamiche Il pulsante **Aggiungi variabili**, sotto l'editor del prompt, ti permette di inserire segnaposto nel testo — per esempio il nome dell'agente, l'azienda, la città o un servizio. Puoi usare variabili di sistema, variabili personalizzate o creare al volo una nuova variabile. Quando crei una nuova variabile, appare come chip sotto l'editor e viene aggiunta al pannello **Variabili dinamiche**, più in basso, dove le assegni il suo valore reale. È la scelta giusta quando vuoi riutilizzare lo stesso agente per marchi, sedi o servizi diversi senza riscrivere il prompt ogni volta. ### Fuso orario Proprio accanto all'editor del prompt c'è un selettore di fuso orario (per esempio, **Madrid (GMT+1)**). È il riferimento orario che l'agente usa quando parla di *oggi*, *domani*, *questo pomeriggio* o di un momento specifico durante la chiamata. Imposta sempre il fuso orario reale dell'attività che l'agente rappresenta. Un fuso sbagliato porta a confermare appuntamenti all'ora errata. ### Personalità predefinita La **Personalità predefinita** è un preset di comportamento che integra il tuo prompt. Rivedila insieme al prompt in modo che il tono finale corrisponda davvero a ciò che vuoi far ascoltare a chi chiama. ### Messaggio di benvenuto Il **Messaggio di benvenuto** è la prima cosa che l'agente dice quando inizia la chiamata. Un buon benvenuto dice a chi chiama con chi sta parlando e che tipo di aiuto può ricevere, in una sola frase breve. Alcuni esempi: * Supporto: "Ciao, sono l'assistente di supporto. Dimmi cosa succede e ti aiuto passo passo." * Appuntamenti: "Ciao, sono l'assistente per le prenotazioni. Posso aiutarti a fissare, modificare o annullare un appuntamento." * Reception: "Ciao, grazie per aver chiamato. Sono l'assistente virtuale e ti aiuterò con la tua richiesta." ### Consenti interruzioni Quando **Consenti interruzioni** è attivo, chi chiama può parlare sopra l'agente e l'agente si ferma ad ascoltare. Rende la conversazione naturale e di solito è una buona impostazione predefinita per supporto, reception e la maggior parte dei flussi di assistenza clienti. > **Errore comune:** Disattivare le interruzioni quando il tuo messaggio di benvenuto contiene informazioni critiche che chi chiama deve sentire per intero. Se non è il tuo caso, lascialo attivo. ### Voce **Voce** controlla come suona il tuo agente. La voce non cambia *cosa* dice, ma incide molto su come si percepisce la chiamata — chiarezza, fiducia e impressione generale. Il pannello di selezione voce ha tre schede: * **Esplora** — il catalogo delle voci disponibili, con filtri per lingua e genere e una breve descrizione di ciascuna. * **Clonate** — voci che hai clonato o importato nel tuo account. * **Aggiungi** — importa una voce da ElevenLabs incollando un link condiviso. Puoi anche usare **Aggiungi voce aggiuntiva** per inserire voci secondarie, utile quando un agente deve gestire più lingue o segmenti di clientela diversi. Ogni voce ha le proprie regolazioni: * **Modalità espressiva** — quanto è espressiva. * **Velocità** — quanto velocemente parla. * **Stabilità** — equilibrio tra espressività e coerenza. * **Somiglianza** — quanto preserva la sua identità vocale originale. ### Impostazioni comuni della voce Sotto l'elenco delle voci ci sono due controlli audio globali: * **Formato di output TTS** — formato dell'audio generato. **PCM 16000 Hz** è l'opzione consigliata per la maggior parte dei casi perché offre un buon equilibrio tra qualità audio e velocità di elaborazione. * **Ottimizza latenza dello streaming** — controlla l'equilibrio tra il tempo che l'agente impiega a iniziare a parlare e la qualità dell'audio. Più ottimizzazione significa partire prima ma con qualità leggermente inferiore. ### Lingua **Lingua** definisce la lingua predefinita dell'agente e le lingue aggiuntive a cui può passare durante la conversazione. Attiva solo le lingue che ti servono davvero. Aggiungere lingue "per ogni evenienza" tende a rendere il comportamento meno prevedibile. ### Intelligenza IA (LLM) L'**Intelligenza IA (LLM)** è il modello linguistico che alimenta l'agente. Un **LLM** (Large Language Model, modello linguistico di grandi dimensioni) è ciò che capisce chi chiama, segue le regole del prompt, usa la base di conoscenza e genera ogni risposta. Il modello incide direttamente su tre cose: * Quanto bene l'agente capisce ciò che chi chiama vuole dire. * Quanto velocemente risponde (vedrai una latenza approssimativa accanto a ciascun modello, per esempio *\~179ms*). * Quanto rimane coerente in conversazioni lunghe. I modelli disponibili includono **Neuron 1.0**, **GPT-OSS 120B**, **GLM-4.5 Air**, **GPT-4.1 Nano**, **GPT-5 Nano**, **Gemini 2.5 Flash Lite**, **Gemini 2.5 Flash** e **Claude Haiku 4.5**. Per agenti dedicati ad appuntamenti e prenotazioni, **Gemini 2.5** è una scelta pratica e solida. ### Temperatura La **Temperatura** controlla quanta variazione l'agente aggiunge alle proprie risposte. Una temperatura bassa produce risposte più stabili e prevedibili. Una temperatura alta introduce più variazione e meno controllo. Per agenti di supporto, appuntamenti e operatività generale, mantieni la temperatura bassa. Riserva le temperature alte per casi creativi o esplorativi. ### Direzione della chiamata La **Direzione della chiamata** decide come l'agente partecipa al flusso delle chiamate: * **In entrata** — l'agente risponde alle chiamate ricevute (supporto, reception, assistenza clienti). * **In uscita** — l'agente effettua chiamate (campagne, promemoria, conferme, follow-up). * **Entrambe** — lo stesso agente lavora sia in entrata che in uscita. ### Salvare e validare **Salva** memorizza la configurazione corrente. **Pulisci** annulla le modifiche non salvate. Dopo ogni modifica importante, fai una chiamata reale di prova e controlla il messaggio di benvenuto, la voce, le lingue attive, il modello scelto e i valori delle variabili dinamiche. > **Importante:** Una buona configurazione dell'agente deve suonare bene in una chiamata reale, non solo essere corretta nell'editor. ## Sezione 2: Flusso di lavoro La scheda **Flusso di lavoro** è il posto in cui decidi come si muove la conversazione. Mentre la scheda **Agente** definisce chi è l'assistente, **Flusso di lavoro** definisce il percorso che la chiamata segue: rami a seconda di ciò che vuole chi chiama, trasferimenti, chiamate a strumenti e chiusure pulite. Lo costruisci su una tela visiva posizionando nodi e collegandoli tra loro.Schermata: la tela del flusso di lavoro, dove disegni i percorsi della conversazione dall'inizio alla fine.
### Cosa puoi costruire qui A partire da un unico punto d'ingresso, puoi: * Creare più percorsi all'interno della stessa conversazione. * Inviare la chiamata a un **Sottoagente** per una fase specializzata. * Trasferire la chiamata a un altro agente. * Trasferire la chiamata a un numero di telefono. * Eseguire uno strumento già esistente. * Chiudere la conversazione con un nodo **Fine**. * Controllare quale percorso si applica con condizioni di tipo **Condizione LLM**. ### Inizio **Inizio** è il punto d'ingresso. Ogni conversazione comincia qui. Questo nodo non parla e non agisce da solo — lancia semplicemente il percorso e invia la chiamata al nodo successivo. Il pannello laterale del nodo **Inizio** ha due schede: * **Riepilogo** — spiega il suo ruolo. * **Connessioni** — elenca tutti i percorsi in uscita dal nodo, con etichetta e destinazione. ### Transizioni e condizioni LLM Una transizione è la linea che collega un nodo al successivo. Ogni transizione ha un'etichetta visibile e una **Condizione LLM** — un breve testo che indica al modello quando applicare quel percorso. Esempi di condizioni: * "Usa questo percorso quando l'utente ha bisogno di assistenza tecnica con la piattaforma." * "Usa questo percorso quando l'utente chiede di parlare con una persona." * "Usa questo percorso quando il problema è risolto e la conversazione deve terminare." Le impostazioni operative delle transizioni si trovano nella scheda **Avanti**. ### Completa la configurazione del flusso Il pannello **Completa la configurazione del flusso** ti dice esattamente cosa manca per salvare correttamente il flusso. È molto utile nei flussi grandi perché indica il nodo o la connessione precisi che hanno ancora bisogno di attenzione. Avvisi tipici: * Un nodo di **Trasferimento ad agente** senza agente di destinazione. * Un nodo di **Strumento** senza strumento selezionato. * Una transizione senza testo della condizione. * Un nodo o un ramo ancora incompleto. ### Sottoagente Un **Sottoagente** è una fase specializzata all'interno dello stesso flusso di lavoro. Usalo quando una parte della conversazione richiede obiettivo, voce, modello o comportamento propri, diversi da quelli dell'agente principale. All'interno di un nodo Sottoagente puoi configurare: * **Generale** — prompt di sistema, prompt di sostituzione, voce, LLM, predisposizione e pazienza nello spelling. * **Base di conoscenza** — attiva **Eredita base di conoscenza** per usare quella dell'agente principale, oppure assegnane una diversa. * **Strumenti** — attiva **Eredita strumenti personalizzati** o aggiungi strumenti specifici con **Aggiungi strumento**. Gli strumenti non vengono creati qui. Si creano nella sezione **Strumenti** e dal flusso si possono solo selezionare o ereditare. ### Nodo strumento Il nodo **Strumento** invia la conversazione a una fase in cui l'agente usa uno strumento già esistente. Questo nodo non crea nuovi strumenti — collega solamente il flusso a uno strumento già configurato. ### Trasferimento ad agente Il **Trasferimento ad agente** consegna la conversazione a un altro agente del tuo account. Usalo quando la chiamata deve passare a un assistente specializzato in un altro compito, un'altra lingua o un altro flusso. Puoi configurare: * L'agente di destinazione. * Un ritardo in millisecondi prima del trasferimento. * Un messaggio di trasferimento e se riprodurlo o no. Esempi di messaggio di trasferimento: * "Ti passo all'agente più adatto per questa richiesta." * "Ti collego con l'assistente specializzato in questo tipo di domanda." ### Trasferimento a numero di telefono Il **Trasferimento a numero di telefono** invia la chiamata a un numero telefonico. Usalo quando la conversazione deve uscire dall'agente e proseguire su una linea telefonica specifica. Il tipo di destinazione può essere: * **Numero di telefono** — un numero fisso, ideale per reception, una linea commerciale o una linea dedicata di supporto. * **Variabile dinamica del telefono** — la destinazione viene decisa a runtime in base al contesto della conversazione. ### Fine Il nodo **Fine** chiude la conversazione. Quando il percorso lo raggiunge, la chiamata termina. Usalo quando: * La questione è completamente risolta. * Un ramo deve chiudersi in modo pulito. * Una fase è completa e non deve proseguire. ### Duplica ed elimina Ogni nodo ha controlli per duplicarlo o eliminarlo. **Duplica** aiuta a costruire più rapidamente rami simili. Prima di eliminarne uno, controlla le transizioni a esso collegate per non rompere un percorso attivo. ### Impostazioni globali Le **Impostazioni globali** riguardano il flusso di lavoro nel suo insieme. **Evita cicli infiniti** aggiunge un livello di sicurezza che impedisce alla conversazione di restare intrappolata in un ciclo senza progressi. Per disattivare un flusso senza eliminarlo, scollega il nodo **Inizio**. Senza un Inizio collegato, il flusso non ha punto d'ingresso e non viene eseguito. ### Salvare e provare **Salva** memorizza il flusso corrente. **Pulisci** annulla le modifiche non salvate. L'avviso di modifiche non salvate compare quando hai modifiche ancora non memorizzate. > **Errore comune:** Un flusso può sembrare completo sulla tela e fallire comunque nella pratica. Prova ogni percorso con una conversazione reale prima di pubblicare. ## Sezione 3: Base di conoscenza La scheda **Base di conoscenza** collega il tuo agente a una fonte di contenuto di riferimento che hai già preparato dentro Callin.io. Così l'agente ha accesso a informazioni dettagliate senza doverle inserire tutte nel prompt. Usala quando il contenuto è troppo lungo, troppo dettagliato o cambia troppo spesso per stare nel prompt.Schermata: la scheda Base di conoscenza, dove colleghi all'agente una fonte di conoscenza già esistente.
### A cosa serve questa scheda Questa scheda collega una base di conoscenza esistente a un agente specifico. **Non** crea contenuto da zero — quello si fa nel gestore globale delle basi di conoscenza. Accesso rapido: * [Apri il gestore delle basi di conoscenza](https://app.callin.io/knowledge-base) Un modo utile di pensarci: * Il **prompt** definisce come deve comportarsi l'agente. * La **base di conoscenza** definisce il contenuto di riferimento che l'agente può consultare quando risponde. ### Quando usare una base di conoscenza Usala quando il contenuto è: * Lungo (manuali, policy, documentazione interna). * Soggetto a cambiamenti frequenti. * Già pubblicato come articoli o pagine. * Meglio mantenuto separato dal prompt, per facilitarne gli aggiornamenti. Fonti tipiche: domande frequenti, guide di prodotto, articoli di supporto, documenti di policy, riferimenti interni. ### Fonti di contenuto supportate Una base di conoscenza si può costruire da due tipi di fonti: * **File** — documenti caricati. * **URL web** — pagine o documentazione pubblicate online. Scegli tra queste opzioni nel pannello di selezione. ### Cosa vedi quando una base è collegata Quando l'agente ha già una base di conoscenza collegata, la scheda mostra: * Il nome del gruppo selezionato. * Il numero di documenti collegati. * Le azioni disponibili: **Rimuovi**, **Aggiorna** e **Cambia**. ### Azioni principali * **Cambia** — apre il pannello di selezione per scegliere un'altra base. * **Rimuovi** — scollega la base attualmente collegata. * **Aggiorna** — rinfresca il collegamento perché l'agente lavori con l'ultima versione della selezione collegata. ### Pannello di selezione della base di conoscenza Cliccando **Cambia** si apre questo pannello. Da qui puoi rivedere ciò che è disponibile, scegliere un gruppo, ispezionarne il contenuto e confermare. Cosa trovi dentro: * **Fonte** — alterna tra **File** e **URL web**. * **Gruppi** — elenco delle basi di conoscenza nella fonte scelta. * **Aggiorna** — ricarica l'elenco dei gruppi. * **Documenti / URL** — risorse appartenenti al gruppo selezionato. * **Collegato** — segna che una risorsa sarà disponibile per l'agente alla conferma. * **Seleziona** — conferma la scelta. * **Chiudi** — esce senza modifiche. ### Flusso consigliato Il modo più pulito di lavorare è separare creazione e selezione: 1. Crea e organizza la base di conoscenza nel gestore globale. 2. Torna a questa scheda e collega all'agente la base preparata. > **Suggerimento:** Tieni le regole di comportamento nel prompt e il contenuto di riferimento nella Base di conoscenza. Questa separazione rende molto più facili gli aggiornamenti. ## Sezione 4: Strumenti La scheda **Strumenti** decide cosa il tuo agente può davvero *fare* durante una chiamata, oltre a sostenere la conversazione. Mentre il prompt definisce come parla e il flusso definisce come si muove la chiamata, gli strumenti gli permettono di eseguire azioni nel momento giusto. Questa scheda fa due cose: ti permette di aggiungere **strumenti personalizzati** creati dal tuo team e di attivare e configurare gli **strumenti di sistema** che Callin.io include di serie.Schermata: la scheda Strumenti, con la sezione degli strumenti personalizzati in alto e gli strumenti di sistema in basso.
Accesso rapido: * [Apri la sezione globale Strumenti](https://app.callin.io/tools) ### Strumenti personalizzati Gli **strumenti personalizzati** sono strumenti che il tuo team crea per casi d'uso specifici. Non si creano dentro l'agente — prima li costruisci nella sezione globale **Strumenti**, poi torni qui per aggiungerli. Cose tipiche che uno strumento personalizzato può fare: * Interrogare un sistema esterno. * Eseguire un'automazione. * Inviare o ricevere dati tramite un **webhook** (un URL che il tuo strumento chiama quando accade qualcosa). * Avviare logiche specifiche del tuo business. * Collegare l'agente a un altro servizio. Se l'agente non ha ancora strumenti personalizzati, quest'area mostra lo stato vuoto. Il pulsante **Aggiungi strumento** associa uno strumento personalizzato all'agente. Se il tuo account contiene già strumenti, il selettore ti permette di cercarli e sceglierli. Se non ce ne sono, ti offre l'opzione diretta di creare uno **Strumento webhook**. ### Strumenti di sistema Gli **strumenti di sistema** sono strumenti integrati che coprono situazioni comuni di chiamata senza che tu debba costruire nulla. Ognuno si attiva o disattiva separatamente e alcuni hanno una configurazione aggiuntiva. #### Chiusura intelligente Permette all'agente di chiudere la chiamata in modo pulito quando rileva che la conversazione è già finita — per esempio quando chi chiama saluta, conferma che il problema è risolto o conclude chiaramente. Evita di tenere la linea aperta più a lungo del necessario. #### Cambio di lingua Aiuta l'agente a gestire un cambio di lingua durante la chiamata. Particolarmente utile quando l'agente lavora con più lingue e chi chiama può cambiare all'inizio o a metà della conversazione. #### Ascolto intelligente Migliora il modo in cui l'agente ascolta e gestisce la conversazione in tempo reale. Si controlla con un unico interruttore di attivazione. #### Trasferimento ad agente Consegna la conversazione a un altro agente del tuo account. Utile per spostare una chiamata da un agente generalista a uno specializzato — per esempio da un assistente generale a uno commerciale o a un agente di supporto senior. #### Trasferimento a numero Trasferisce la chiamata a un numero telefonico umano. È uno degli strumenti più importanti quando devi escalare la chiamata fuori dall'agente e affidarla a una persona — reception, centralino, vendite o un ufficio specifico. #### Regole di trasferimento umano Definiscono le regole specifiche per il trasferimento agli umani. Ogni regola include: * **Tipo di destinazione** — un numero fisso oppure un numero fornito tramite una variabile dinamica. * **Numero di telefono** o la variabile dinamica del telefono. * **Condizione** — quando applicare questa regola. Usa un numero fisso quando la destinazione è sempre la stessa e una variabile dinamica quando dipende dal contesto della conversazione. #### Rilevamento segreteria Rileva quando la chiamata è finita su una segreteria telefonica e agisce di conseguenza. È fondamentale per agenti in uscita, dove molte chiamate finiscono in segreteria. Hai due opzioni: * Lasciare vuoto il messaggio della segreteria se la chiamata deve terminare al rilevamento. * Scrivere un messaggio se vuoi che il sistema lo riproduca prima di chiudere. #### Descrizione e disabilita interruzione Diversi strumenti di sistema includono due campi aggiuntivi: * **Descrizione** — spiega al modello come e quando deve essere usato lo strumento. * **Disabilita interruzione** — controlla se lo strumento può essere interrotto durante l'esecuzione. ### Come scegliere gli strumenti Non attivare tutto. Scegli in base al caso d'uso: * Un agente in entrata di supporto usa spesso **Chiusura intelligente**, **Cambio di lingua** e **Ascolto intelligente**. * Un agente che escala agli umani usa **Trasferimento a numero** con regole di trasferimento ben definite. * Un agente in uscita usa spesso **Rilevamento segreteria**, **Chiusura intelligente** e **Cambio di lingua**. > **Errore comune:** Attivare troppi strumenti contemporaneamente. Rende il comportamento più difficile da prevedere, da testare e da mantenere. ## Sezione 5: Azione di chiamata La scheda **Azione di chiamata** è il punto in cui l'agente smette di essere solo una voce e inizia a produrre risultati utili: prenotazioni, email di follow-up, segnalazioni registrate, dati strutturati e record sincronizzati. Usala per trasformare la conversazione in passi successivi concreti su cui il tuo team possa agire.Schermata: la scheda Azione di chiamata, dove automatizzi cosa accade durante e dopo ogni chiamata.
Accesso rapido: * [Configura Google Calendar](https://app.callin.io/actions/google-calendar) * [Configura Cal.com](https://app.callin.io/actions/cal) ### Prenotazione appuntamenti Permette all'agente di prenotare riunioni direttamente durante la chiamata. Particolarmente utile in vendite, onboarding e ogni flusso in cui prenotare al momento ti evita di rincorrere il cliente in seguito. Prima di attivarla, collega un fornitore di calendario: * **Google Calendar** — la scelta migliore quando vuoi prenotare direttamente su un calendario Google collegato. * **Cal.com** — la scelta migliore quando la tua operatività di prenotazioni si appoggia già a Cal.com. > **Importante:** Il fuso orario dell'agente e quello del calendario devono coincidere. Se non coincidono, l'agente proporrà o confermerà orari sbagliati. ### Email di riepilogo dopo la chiamata Invia automaticamente un'email quando termina la chiamata, per tenere informati responsabili e team senza follow-up manuale. Puoi configurare: * I destinatari. * L'oggetto. * Il corpo base del messaggio. * La lingua dell'email. * Se includere i dati della chiamata. * Se includere i campi estratti (vedi *Cattura informazioni* più sotto). ### Disiscrizione intelligente Offre a chi chiama un modo chiaro e rispettoso per dire "non contattatemi più". Importante nei flussi in uscita, dove le richieste di cancellazione devono essere catturate e rispettate in automatico. ### Registrazione segnalazioni e reclami Rileva segnalazioni o reclami durante la chiamata e li registra in modo che il tuo team possa rivederli, fare follow-up o scalarli. Attivala quando vuoi che ogni conversazione possa generare un caso che merita di essere trattato dopo. ### Sincronizzazione dati (webhook post-chiamata) Invia i dati catturati a un altro sistema appena finisce la chiamata. È la scelta giusta quando lavori con un CRM, una piattaforma di automazione o qualunque strumento interno che ha bisogno dei dati senza copia-incolla. Per configurarla, indica l'URL del webhook che riceverà i dati e conferma in anticipo quale sistema li riceverà e come li elaborerà. ### Cattura informazioni (estrazione dati) Trasforma la conversazione in dati strutturati — nomi, date, preferenze, città, prodotti d'interesse, motivi di contatto, ecc. Usa **Aggiungi entità** per definire cosa catturare. Ogni entità ha: * **Tipo di dato** — il tipo di valore che vuoi catturare. * **Identificatore** — il nome interno con cui viene memorizzato. * **Descrizione** — esattamente cosa il sistema deve estrarre. * **Valori ammessi** — un elenco chiuso opzionale di valori validi, quando vuoi risultati più consistenti. ### Salva i dati nel contatto Quando questo è attivo, le informazioni estratte vengono salvate nel profilo del contatto. Utile quando vuoi riutilizzare quei dati in chiamate future o tenere schede di contatto più ricche. ### Nuovi tentativi di chiamata Configura nuovi tentativi automatici quando una chiamata non si connette. Si usa soprattutto negli agenti in uscita, dove molte chiamate non vengono risposte o finiscono in segreteria. Puoi configurare: * **Numero di tentativi** — quante volte il sistema deve riprovare prima di rinunciare. * **Tempo di attesa tra tentativi** — quanti minuti aspettare tra un tentativo e il successivo. > **Suggerimento:** Attiva solo le azioni che il tuo team userà davvero. Ogni automazione che accendi è un piccolo impegno di manutenzione. Poche e ben scelte funzionano meglio di un lungo elenco usato a metà. ## Sezione 6: Widget per sito web La scheda **Widget per sito web** ti permette di pubblicare il tuo agente su una pagina web. I visitatori possono parlargli con la voce, in chat o con entrambe, direttamente dal tuo sito, da una landing, da una pagina di supporto o da un portale clienti. Questa scheda combina due cose: il frammento tecnico per integrare il widget e la personalizzazione visiva e testuale dell'esperienza.Schermata: la scheda Widget per sito web, dove prepari il widget pubblico e personalizzi l'esperienza del visitatore.
### Frammento di integrazione Il **Frammento di integrazione** è il codice che copi nell'HTML del tuo sito perché il widget appaia. Il pulsante **Copia** lo copia negli appunti per incollarlo direttamente. Dove incollarlo dipende dalla modalità del widget: * **Inserito in linea** — incollalo esattamente dove vuoi che il widget venga mostrato sulla pagina. * **Avvio fluttuante** — incollalo verso la fine del corpo della pagina perché funzioni come punto d'ingresso fluttuante. ### Layout e comportamento Questo blocco decide come il widget viene incorporato e come i visitatori interagiscono con esso. #### Modalità del widget Come appare il widget sul tuo sito: * **Inserito in linea** — mostra il widget completo dentro la pagina, dove hai incollato il frammento. * **Avvio fluttuante** — mostra un pulsante fluttuante che apre il widget al clic. #### Tema del widget Controlla l'aspetto generale: * **Come l'app** — segue il tema usato dal tuo sito. * **Chiaro** — modalità chiara. * **Scuro** — modalità scura. Scegli l'opzione che si adatta al design del tuo sito. La leggibilità e la coerenza di marca vengono prima. #### Modalità di conversazione Come possono interagire i visitatori: * **Solo voce** — solo interazione vocale. * **Solo chat** — solo testo. * **Voce e chat** — entrambe. ### Aspetto Controlla lo stile visivo del dial e dell'avvio. #### Variante del widget e dimensione del dial * **Variante del widget** — dimensione visiva di base: **Mini**, **Compatta** o **Completa**. * **Dimensione del dial** — il valore minimo e massimo del dial in pixel. #### Trascrizione in tempo reale e pulsante muto * **Trascrizione in tempo reale** — mostra una trascrizione live della conversazione mentre la chiamata è in corso. * **Mostra pulsante muto** — mostra un pulsante con cui il visitatore può silenziare e riattivare il microfono durante la chiamata. #### Colori dell'orbita * **Colore primario dell'orbita** e **Colore secondario dell'orbita** — i colori principali del widget. Usa i colori del tuo brand mantenendo un contrasto sufficiente per la leggibilità. ### Etichette del dial Testi mostrati al centro del dial a seconda dello stato della conversazione: * **Stato in attesa** * **In connessione** * **In ascolto** * **Interruzione** ### Etichette di testo Testi generali dell'interfaccia che puoi personalizzare: * **Etichetta principale** * **Inizia chiamata** * **Inizia chat** * **Termina chiamata** * **Stato chat in corso** * **Segnaposto di input per una nuova conversazione** ### Etichette dell'interfaccia chat Testi specifici dell'esperienza chat: * **Etichetta della scheda voce** * **Etichetta della scheda chat** * **Titolo della chat** * **Sottotitolo della chat** * **Stato della chat: in attesa, in connessione e attiva** * **Etichetta di inizio chat** * **Etichetta di fine chat** * **Stato vuoto della chat** * **Segnaposto di input della chat: in attesa e attivo** * **Etichetta di invio della chat** ### Adattare il widget al tuo caso Alcune combinazioni che funzionano bene: * **Landing commerciale** — Inserito in linea, tema chiaro o uguale all'app, **Voce e chat**, variante **Completa**, testi orientati al contatto. * **Supporto web** — Avvio fluttuante, **Solo chat** o **Voce e chat**, variante **Compatta**, testi orientati all'aiuto. * **Esperienza vocale** — Inserito in linea, **Solo voce**, dial più grande, pulsante muto visibile, etichette brevi e dirette. > **Suggerimento:** Prima di pubblicare, prova il widget sulla pagina reale dove vivrà. Dimensioni, colori ed etichette spesso si percepiscono diversamente fuori dall'editor. ## Sezione 7: Avanzate La scheda **Avanzate** è dove rifinisci l'agente: come cattura l'audio, come gestisce il silenzio, come tratta i dati di chiamata e come si comporta in scenari di telefonia in uscita. La maggior parte degli agenti funziona bene senza toccare nulla qui. Apri questa scheda quando vuoi più precisione o quando qualcosa di specifico non funziona come dovrebbe.Schermata: la scheda Avanzate, organizzata in quattro blocchi per affinare l'agente.
La scheda è divisa in quattro blocchi: **Voce e comprensione**, **Flusso di conversazione**, **Privacy e dati** ed **Extra di telefonia**. ### Voce e comprensione Regola come l'agente cattura l'audio e come dà priorità a determinati termini. #### Qualità di cattura della voce Definisce il formato audio con cui viene processato il parlato. Le opzioni includono **PCM 8000 Hz**, **PCM 16000 Hz**, **PCM 22050 Hz**, **PCM 24000 Hz**, **PCM 44100 Hz**, **PCM 48000 Hz** e **ulaw 8000 Hz**. Per la maggior parte delle configurazioni, lascialo su **PCM 16000 Hz**. È il miglior equilibrio tra qualità audio e velocità di elaborazione. **ulaw 8000 Hz** è pensato specificamente per scenari di telefonia. #### Parole chiave prioritarie Ti permette di elencare termini a cui l'agente deve dare priorità nel riconoscimento del parlato. Utile per nomi di marchi, prodotti, termini tecnici, acronimi, codici o cognomi poco comuni che il modello potrebbe altrimenti fraintendere. ### Flusso di conversazione Controlla il ritmo dell'agente: quanto rapidamente prende la parola, quanto è paziente con chi parla lentamente e quando deve chiudere dopo un silenzio. #### Predisposizione a parlare Quanto velocemente l'agente prende la parola dopo che chi chiama smette di parlare: * **Paziente** — aspetta più a lungo prima di rispondere. * **Normale** — equilibrato. * **Pronto** — risponde rapidamente. **Normale** funziona bene nella maggior parte dei casi. #### Pazienza nello spelling Rende l'agente più paziente quando chi chiama detta lettera per lettera — nomi, email, numeri identificativi. Opzioni: * **Auto** — consigliata quando l'agente raccoglie spesso informazioni dettate. * **Disattivato** — mantiene il ritmo standard. #### Prendi il turno dopo silenzio Quanti secondi di silenzio l'agente aspetta prima di prendere la parola. Valori bassi rendono l'agente più reattivo; valori alti danno più spazio a chi chiama per pensare. #### Termina conversazione dopo silenzio Quanto deve durare un silenzio perché la chiamata termini automaticamente. Utile quando chi chiama smette del tutto di rispondere. #### Durata massima della conversazione Durata massima di una singola chiamata. Una rete di sicurezza che impedisce alle chiamate di prolungarsi all'infinito. > **Suggerimento:** Se non sai cosa impostare nei campi di silenzio e durata, lasciali sul valore predefinito e regolali solo dopo aver provato con chiamate reali. ### Privacy e dati #### Registrazione chiamate Quando è attiva, il sistema memorizza in modo sicuro l'audio e la trascrizione delle chiamate. Attivala solo se è compatibile con le tue policy interne di privacy, archiviazione e conformità. ### Extra di telefonia Impostazioni specifiche di telefonia, soprattutto orientate a migliorare le prestazioni delle chiamate in uscita. #### Rotazione dei numeri Ruota automaticamente tra i numeri di telefono disponibili. Aiuta a ridurre il rischio che un numero venga marcato come spam, distribuisce il volume di chiamate e migliora la deliverability. #### Selezione dei numeri e chiamate per numero * **Seleziona numeri di telefono** — scegli quali numeri partecipano alla rotazione. Quando la **Rotazione dei numeri** è attiva, almeno uno deve essere selezionato. * **Chiamate per numero** — quante chiamate fare da un numero prima di passare al successivo. #### Restrizione per stato Limita le chiamate in modo che l'agente componga il numero usando un numero locale dello stesso stato del contatto. È pensata per numeri locali statunitensi — verifica che il tuo account abbia numerazione locale compatibile prima di attivarla. > **Importante:** Cambia le impostazioni avanzate solo quando hai un motivo chiaro e puoi verificare il risultato con chiamate reali. Modifiche casuali qui di solito creano nuovi problemi invece di risolvere quelli esistenti. # Tools Source: https://support.callin.io/Create-AI-Agent/Create-Tools Create tools (webhooks) in Callin and use them from your agent’s Conversation Prompt field to send or query data in real time during a call. ## Overview **Tools** (webhooks) allow your Callin agent to connect with external systems **in real time** while speaking with a user. Put simply: a tool is an **automatic action** the agent can run to **ask** or **send** information to another system (for example, your CRM) without interrupting the conversation. With a tool, your agent can: * **Send data** the user says during the call (for example: name, email, phone, reason). * **Query data** from an external system (for example: status, availability, verification). * **Trigger automations** in external platforms (CRM, tickets, messaging, workflows, etc.). In Callin, correct operation always follows this order: 1. **Create the tool** in the **Tools** section. 2. **Assign the tool** to the agent in **AI Agents**. 3. **Specify in the Conversation Prompt field** when it must run and what the agent should do with the result. If any of these 3 steps is missing, the tool will not run as expected. *** ## Before you start (concepts in 60 seconds) * **Tool**: a connection that lets the agent “talk” to another system (for example, a CRM). * **URL**: the address Callin sends the request to. * **GET**: used to **query** information (“Does this contact exist?”). * **POST**: used to **send** information (“Create this lead with these details.”). * **Body parameters**: the **data** the agent will send (email, phone, name, etc.). * **Required**: **mandatory** fields. If one is missing, the result may be incomplete or the flow can fail. > If your user is not technical, keep this idea: **the tool creates the connection**, and the **Conversation Prompt decides when it is used and with which data**. *** ## Step 1 — Create a tool (webhook) To create a tool in Callin: 1. Go to **Tools** in the Callin dashboard. 2. Click **+ Add Tool**. 3. Fill in the main fields: * **Name**\ Use a short, clear, stable name. Recommendation: **verb + objective**.\ Examples: `query-crm-contact`, `create-crm-lead`, `send-registration-link`. * **Description**\ Explain **what it does** and, especially, **when it must be used** (at what moment in the call).\ Example: “Check whether the contact exists in the CRM only after confirming email and phone.” * **Method** * Use **GET** if you are going to **query** information. * Use **POST** if you are going to **send** information (most common when the agent collects data and sends it). * **URL**\ Paste the HTTPS URL of your API or your external platform webhook. > Make sure the URL is **HTTPS** and publicly accessible. If the endpoint is not accessible, the tool will not work. ### Configure “Body parameters” (if you use POST) If your tool sends information (POST), define exactly which data it will send: 1. Go to **Body parameters**. 2. Click **Add property**. 3. Configure each field: * **Type**: the data type (text, number, true/false, etc.). * **Identifier**: the exact field name your endpoint expects (for example: `email`, `phone`, `full_name`). * **Required**: enable it if the field is mandatory. * **Description**: explain what it represents and the expected format (for example: “Phone in international format” or “Valid email address”). > Practical recommendation: if you mark a field as **Required**, your agent must be forced (via the Conversation Prompt) to **ask for it and confirm it** before running the tool. Otherwise, the webhook will receive incomplete data or the flow will fail. ### Headers and authentication (if applicable) If your endpoint requires authentication (for example, a token or key), you must configure it following your API requirements exactly (which headers it needs and what values). 4. Click **Save** to save the tool. *** ## Step 2 — Assign the tool to an agent Creating the tool is not enough. You must assign it to the agent: 1. Go to **AI Agents**. 2. Select the agent you want to configure. 3. In the agent editor, scroll down to the **Tools** section. 4. Click **+ Add Tool**. 5. Select the tool and save. **Quick check:**\ If the tool appears in the agent’s list, it is assigned correctly. If it does not appear, the agent will not be able to run it. *** ## Step 3 — Specify how to use the tool in “Conversation Prompt” This is the most important step. The agent will only run the tool if the **Conversation Prompt** clearly tells it: * **What data it must collect** before running it (required fields). * **How to confirm that data** (to reduce errors). * **When** it must run it (exact moment in the call). * **What it must say right after** running it (including exact phrases if your process requires them). * **What it must NOT do** (to avoid mixing flows or acting too early). ### Key rule (for non-technical users) If you don’t tell the agent **“when”** and **“under what conditions”** to use the tool, the agent may: * use it too early, * use it with incomplete data, * or never use it at all. *** ## Example 1 — Connect to a CRM in real time (query + create) This example covers a very common case: the agent speaks with a user and, **before continuing**, checks the CRM to see if the contact already exists. If it doesn’t, it creates the user as a lead and continues the call. ### Tools used in this example **Tool 1: Query\_CRM\_Contact**\ **Goal:** check whether the contact already exists in the CRM.\ **When it is used:** right after confirming **email + phone**.\ **Expected result:** “found / not found” and, if found, basic details (for example: name and status). **Tool 2: Create\_CRM\_Lead**\ **Goal:** create a lead if the contact does not exist.\ **When it is used:** only if the previous query returns “not found”.\ **Minimum recommended data:** name, email, phone, reason. ### Conditions to run the tools (very important) * The agent **must not** run any tool until: * the **email** is confirmed (repeated and confirmed by the user), * and the **phone** is confirmed (repeated and confirmed by the user). * If the user hesitates or corrects a detail, the agent must **update it and confirm again** before continuing. ### What to write in the Conversation Prompt (invented text, easy to adapt) **Flow objective:**\\ 1. Collect basic details → 2) Confirm them → 3) Query CRM → 4) If not found, create lead → 5) Continue the conversation. **Clear instructions for the agent (example):** * During the call, collect and confirm these details: * **First and last name** * **Email** * **Phone** * **Reason** (one short sentence) * To confirm: * Repeat the email and ask: “Is that correct?” * Repeat the phone and ask: “Is that correct?” * Only when email and phone are confirmed: * Run **Query\_CRM\_Contact**. * If the result indicates the contact **exists**: * Tell the user: “Perfect, I can already see your record. Let’s continue.” * Do not invent details. If the status comes in the result, you may mention it neutrally. * If the result indicates the contact **does not exist**: * Tell the user: “Perfect, I can’t find you yet. I’ll register you now and we’ll continue.” * Run **Create\_CRM\_Lead** with the confirmed details. * After creating, confirm: “Done, you are now registered. Let’s continue with the next step.” * If the tool fails or returns no response: * Do not say technical information. * Say: “I couldn’t check it right now. Let’s continue, and if needed we’ll review it at the end.” * Do not repeat tools in a loop. ### How it would look in a call (conversation example) **Agent:** “Perfect. To help you, I just need a few quick details. What’s your first and last name?”\ **User:** “Laura Martin.”\ **Agent:** “Thanks, Laura. What’s your email?”\ **User:** “[laura.martin@example.com](mailto:laura.martin@example.com)”\ **Agent:** “Great. I understood: laura dot martin at example dot com. Is that correct?”\ **User:** “Yes.”\ **Agent:** “Perfect. What’s your phone number?”\ **User:** “Six six five, one two three, four five six.”\ **Agent:** “Perfect. Confirming the phone: 665 123 456. Is that correct?”\ **User:** “Yes.”\ **Agent:** “Thanks. One last thing: in one sentence, what’s the reason for your call?”\ **User:** “I want information about the plans.”\ **Agent:** “Perfect. I’m going to check if you’re already registered and then we’ll continue.” (The agent runs **Query\_CRM\_Contact**) * **If found:**\ **Agent:** “Perfect, I can already see your record. Let’s continue with the information about plans.” * **If not found:**\ **Agent:** “Perfect, I can’t find you yet. I’ll register you now and we’ll continue.” (The agent runs **Create\_CRM\_Lead**) **Agent:** “Done, you are now registered. Now yes—let’s go over the information about plans.” ### Flow safety rules (to avoid errors) * Do not run tools with unconfirmed data. * Do not invent CRM results: only use what comes back in the response. * Do not retry the tool repeatedly if it fails: continue and offer to review it later. * Do not mix flows: first CRM (verify/create), then the rest of the process. *** ## Example 2 — Send links at the right moment (during the call and at the end) Below is a complete (invented) example with two tools: a main link during the call and an access link at the end. **Tool 1: Send\_Registration\_Link (Link A)**\ **Goal:** send the main link where the user completes the full primary process.\ **When it is used:** during the call, only when the user confirms they want to continue and email + phone are confirmed. **Link A includes (inside the link itself):** 1. Initial registration (required details) 2. Verification/confirmation of information 3. Plan or option selection 4. Payment setup (if applicable) 5. Acceptance of terms or signature (if applicable) 6. Document upload (if applicable) 7. Final confirmation **Conditions to run “Send\_Registration\_Link”:** * The user clearly says they want to continue. * The email is confirmed (repeated and confirmed by the user). * The phone is confirmed (repeated and confirmed by the user). **Exact phrase after sending Link A (invented example):** > “Open the link we just sent you and scroll down to the ‘Initial registration’ section. Fill in your details and tell me when you’re ready to continue.” **Rules during the call (very important):** * Do not ask the user to leave Link A to do steps somewhere else during the call. * Do not ask them to log into a separate portal while they are completing the main process. * Guide the user step by step, always from where they currently are. *** **Tool 2: Send\_Portal\_Link (Link B)**\ **Goal:** send the secure portal access link so the user can review progress later.\ **When it is used:** only at the end of the call. **Exact phrases after sending Link B (invented example):** > “Here is the link to access your secure portal.”\ > “We also sent you emails with your login details.”\ > “If you can’t find them, use your email search and type our company name to locate them.” **Final closing (invented example):** > “Thank you for your time. If you need help with any step, we’re available to assist you.” *** ## Step 4 — Test the tool before using it in production Before using the tool with customers, validate that: * The request runs successfully. * The fields arrive with the expected name (Identifier). * The required fields (Required) are always present. * The endpoint responds quickly and consistently. A good practice is to test the webhook with a temporary inspection URL (to see what arrives) and then with your real endpoint. ### Quick checklist (30 seconds) * The tool is created and saved in **Tools**. * The tool is assigned to the agent in **AI Agents > your agent > Tools**. * The **Conversation Prompt** clearly specifies: * what data to ask for, * how to confirm it, * when to run the tool, * and what to say right after. *** ## Common errors and how to fix them | Problem | Likely cause | Solution | | ----------------------------------- | ----------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- | | The tool does not run | It is not assigned to the agent | Go to **AI Agents > your agent > Tools** and add it | | No information reaches the endpoint | Endpoint is inaccessible or URL is incorrect | Verify the URL is **HTTPS** and publicly accessible | | Missing fields | “Identifier / Required” defined incorrectly or the agent doesn’t collect them | Review **Body parameters** and adjust the **Conversation Prompt** to require and confirm the data | | It runs at the wrong time | The Conversation Prompt doesn’t define clear conditions | Specify rules like “only at the end”, “only after confirming email and phone” | *** ## Final tip To achieve a stable result: * Start with a simple tool. * Define only a few required fields at the beginning. * In the Conversation Prompt, be explicit about: * **execution conditions**, * **flow order**, * **exact phrases** (if applicable), * **and prohibitions** (what the agent must not do). # Tools Source: https://support.callin.io/Create-AI-Agent/Create-Tools-copied-1 Nutze Webhooks in Callin, um in Echtzeit Daten von deinem Agenten an jede externe API oder Automatisierungsplattform zu senden oder von dort abzurufen. ## Überblick Webhooks ermöglichen es deinem Callin-Agenten, in Echtzeit mit externen Systemen zu interagieren. Das bedeutet, dass dein Agent jedes Mal, wenn er einen Anruf tätigt oder entgegennimmt, automatisch **Daten senden oder anfordern** kann — über eine einfache HTTP-Anfrage an einen anderen Service. Das ist hilfreich, wenn du möchtest, dass dein Agent Kundendaten abruft, Datensätze in externen Tools erstellt oder Automatisierungen auslöst — alles während eines laufenden Gesprächs. In Callin werden Webhooks als **Tools** erstellt. Das sind wiederverwendbare Komponenten, die du jedem Sprachagenten zuweisen kannst. *** ## Schritt 1: Ein Webhook-Tool erstellen Zum Start musst du ein neues Tool im Callin-Dashboard erstellen: 1. Gehe zu [Tools](https://app.callin.io/tools) in deinem [Callin workspace](https://app.callin.io). 2. Klicke auf **+ Add Tool**. 3. Fülle die folgenden Felder aus: * **Name**: `get-customer-data` * **Description**: `Ruft Kundeninformationen anhand der Telefonnummer ab.` * **Method**: Wähle `GET`, wenn du Daten abrufst, oder `POST`, wenn du sie sendest. * **URL**: Gib den externen API-Endpoint an, z. B. `https://api.mycompany.com/customers` > Stelle sicher, dass die URL HTTPS verwendet und öffentlich erreichbar ist. Andernfalls funktioniert der Webhook nicht. 4. Klicke auf **Save**, um das Tool zu erstellen. *** ## Schritt 2: Das Tool einem Sprachagenten zuweisen Sobald dein Tool erstellt ist, musst du es mit dem Agenten verbinden, der es nutzen soll: 1. Gehe zu [AI Agents](https://app.callin.io/agents). 2. Wähle den Agenten aus, den du konfigurieren möchtest. 3. Scrolle zum Abschnitt **Tools** und klicke auf **+ Add Tool**. 4. Wähle das Tool aus, das du gerade erstellt hast, und speichere deine Änderungen. Jetzt ist dein Agent bereit, diesen Webhook auszuführen, wann immer er während eines Anrufs benötigt wird. *** ## Schritt 3: Deinen Webhook testen Bevor du ihn in Produktion nutzt, ist es wichtig zu testen, ob dein Webhook korrekt konfiguriert ist. Du kannst [Webhook.site](https://webhook.site) verwenden — ein kostenloses Tool, das dir eine temporäre URL gibt, um Testanfragen zu empfangen und die Daten zu prüfen. Hier ist ein Beispiel für ein Payload, das Callin senden könnte: "call\_id": "ab12cd34", "agent\_name": "Laura AI", "duration": 145, "direction": "outbound", "caller\_number": "+34123456789", "summary": "Der Kunde hat um ein Follow-up gebeten." Prüfe, ob das Payload ankommt und ob es zu dem passt, was deine externe API erwartet. *** ## Schritt 4: Mit anderen Plattformen automatisieren Sobald dein Webhook funktioniert, kannst du ihn in Automatisierungstools einbinden, zum Beispiel: * [**Zapier**](https://support.callin.io/Create-AI-Agent/Connect-Zapier): Automatisierungen in über 3.000 Apps auslösen. * [**n8n**](https://support.callin.io/Create-AI-Agent/Connect-N8N): Bedingte Flows und fortgeschrittene Workflows visuell erstellen. * [**Make.com**](https://support.callin.io/Create-AI-Agent/Connect-Make): Leistungsstarke Szenarien entwerfen, ohne Code zu schreiben. Diese Tools können die Webhook-Antwort verarbeiten und Slack-Nachrichten senden, CRM-Leads erstellen, E-Mails auslösen und vieles mehr. *** ## Häufige Fehler und wie du sie behebst | Problem | Wahrscheinliche Ursache | Lösung | | -------------------------- | ---------------------------- | ------------------------------------------------ | | Webhook-URL fehlt | URL-Feld ist leer | Füge einen gültigen HTTPS-Endpoint hinzu | | Tool wird nicht ausgeführt | Nicht dem Agenten zugewiesen | Gehe zu agent > Tools tab > Tool erneut zuweisen | | Keine Daten empfangen | API ist nicht erreichbar | Teste die URL mit Webhook.site | | Timeout-Fehler | API braucht zu lange | Erhöhe das Webhook-Response-Timeout im Tool | *** ## Abschlusstipp Webhooks sind eine der leistungsstärksten Möglichkeiten, um zu erweitern, was dein Callin-Agent leisten kann. Starte mit etwas Einfachem:\ Richte einen `GET`-Webhook ein, um Kundendaten anhand der Telefonnummer abzurufen. Wenn das funktioniert, gehe zu fortgeschrittenen Flows mit **Zapier**, **n8n** oder **Make.com** über. Durch die Kombination von Echtzeit-Sprachautomatisierung und Automatisierung kann dein KI-Agent nicht nur sprechen — er kann Daten abrufen, Aktionen auslösen und Ergebnisse über all deine Tools hinweg vorantreiben. # Herramientas Source: https://support.callin.io/Create-AI-Agent/Create-Tools-copied-2 Crea herramientas (webhooks) en Callin y úsalas desde el campo Conversation Prompt de tu agente para enviar o consultar datos en tiempo real durante una llamada. ## Visión general Las **herramientas** (webhooks) permiten que tu agente de Callin se conecte con sistemas externos **en tiempo real** mientras conversa con un usuario. Dicho de forma simple: una herramienta es una **acción automática** que el agente ejecuta para **preguntar** o **enviar** información a otro sistema (por ejemplo, tu CRM) sin cortar la conversación. Con una herramienta, tu agente puede: * **Enviar datos** que el usuario dicta durante la llamada (por ejemplo: nombre, email, teléfono, motivo). * **Consultar datos** en un sistema externo (por ejemplo: estado, disponibilidad, verificación). * **Activar automatizaciones** en plataformas externas (CRM, tickets, mensajería, flujos, etc.). En Callin, el funcionamiento correcto siempre sigue este orden: 1. **Crear la herramienta** en la sección **Tools**. 2. **Asignar la herramienta** al agente en **AI Agents**. 3. **Indicar en el campo Conversation Prompt** cuándo debe ejecutarse y qué debe hacer el agente con el resultado. Si falta cualquiera de estos 3 pasos, la herramienta no se ejecutará como esperas. *** ## Antes de empezar (conceptos en 60 segundos) * **Tool / Herramienta**: conexión para que el agente pueda “hablar” con otro sistema (por ejemplo, un CRM). * **URL**: la dirección a la que Callin envía la solicitud. * **GET**: se usa para **consultar** información (“¿existe este contacto?”). * **POST**: se usa para **enviar** información (“crea este lead con estos datos”). * **Body parameters**: los **datos** que el agente enviará (email, teléfono, nombre, etc.). * **Required**: campos **obligatorios**. Si falta uno, el resultado será incompleto o el flujo puede fallar. > Si tu usuario no es técnico, quédate con esta idea: **la herramienta hace la conexión**, y el **Conversation Prompt decide cuándo se usa y con qué datos**. *** ## Paso 1 — Crear una herramienta (webhook) Para crear una herramienta en Callin: 1. Entra en **Tools** dentro del panel de Callin. 2. Haz clic en **+ Add Tool**. 3. Completa los campos principales: * **Name**\ Usa un nombre corto, claro y estable. Recomendación: **verbo + objetivo**.\ Ejemplos: `consultar-contacto-crm`, `crear-lead-crm`, `enviar-enlace-registro`. * **Description**\ Explica **para qué sirve** y, sobre todo, **cuándo debe usarse** (en qué momento de la llamada).\ Ejemplo: “Consultar si el contacto existe en el CRM solo después de confirmar email y teléfono.” * **Method** * Usa **GET** si vas a **consultar** información. * Usa **POST** si vas a **enviar** información (lo más habitual cuando el agente recopila datos y los envía). * **URL**\ Pega la URL HTTPS de tu API o el webhook de tu plataforma externa. > Asegúrate de que la URL sea **HTTPS** y accesible públicamente. Si el endpoint no es accesible, la herramienta no funcionará. ### Configurar “Body parameters” (si usas POST) Si tu herramienta envía información (POST), define exactamente qué datos enviará: 1. Ve a **Body parameters**. 2. Haz clic en **Add property**. 3. Configura cada campo: * **Type**: el tipo de dato (texto, número, verdadero/falso, etc.). * **Identifier**: el nombre exacto del campo que espera tu endpoint (por ejemplo: `email`, `telefono`, `nombre_completo`). * **Required**: actívalo si el campo es obligatorio. * **Description**: explica qué representa el campo y el formato esperado (por ejemplo: “Teléfono en formato internacional” o “Email válido”). > Recomendación práctica: si marcas un campo como **Required**, tu agente debe estar obligado (por instrucciones en el Conversation Prompt) a **pedirlo y confirmarlo** antes de ejecutar la herramienta. Si no, el webhook recibirá datos incompletos o el flujo fallará. ### Encabezados y autenticación (si aplica) Si tu endpoint requiere autenticación (por ejemplo, un token o una clave), deberás configurarlo siguiendo los requisitos exactos de tu API (qué encabezados necesita y con qué valores). 4. Haz clic en **Save** para guardar la herramienta. *** ## Paso 2 — Asignar la herramienta a un agente Crear la herramienta no es suficiente. Debes asignarla al agente: 1. Ve a **AI Agents**. 2. Selecciona el agente que vas a configurar. 3. En el editor del agente, baja a la sección **Tools**. 4. Haz clic en **+ Add Tool**. 5. Selecciona la herramienta y guarda. **Comprobación rápida:**\ Si la herramienta aparece listada en el agente, está asignada correctamente. Si no aparece, el agente no podrá ejecutarla. *** ## Paso 3 — Indicar cómo usar la herramienta en “Conversation Prompt” Este es el paso más importante. El agente solo ejecutará la herramienta si el **Conversation Prompt** le deja claro: * **Qué datos debe recopilar** antes de ejecutarla (campos obligatorios). * **Cómo confirmar esos datos** (para reducir errores). * **Cuándo** debe ejecutarla (momento exacto de la llamada). * **Qué debe decir justo después** de ejecutarla (incluyendo frases exactas si tu proceso lo requiere). * **Qué NO debe hacer** (para evitar mezclar flujos o actuar demasiado pronto). ### Regla clave (para usuarios no técnicos) Si tú no le dices al agente **“cuándo”** y **“bajo qué condiciones”** usar la herramienta, el agente puede: * usarla demasiado pronto, * usarla con datos incompletos, * o no usarla nunca. *** ## Ejemplo 1 — Conectar con un CRM en tiempo real (consulta + creación) Este ejemplo está pensado para un caso muy común: el agente habla con un usuario y, **antes de continuar**, comprueba en el CRM si ya existe. Si no existe, lo crea como lead y sigue la llamada. ### Herramientas usadas en este ejemplo **Herramienta 1: Consultar\_Contacto\_CRM**\ **Objetivo:** comprobar si el contacto ya existe en el CRM.\ **Cuándo se usa:** justo después de confirmar **email + teléfono**.\ **Resultado esperado:** “encontrado / no encontrado” y, si está encontrado, datos básicos (por ejemplo: nombre y estado). **Herramienta 2: Crear\_Lead\_CRM**\ **Objetivo:** crear un lead si el contacto no existe.\ **Cuándo se usa:** solo si la consulta anterior devuelve “no encontrado”.\ **Datos mínimos recomendados:** nombre, email, teléfono, motivo. ### Condiciones para ejecutar las herramientas (muy importante) * El agente **no puede** ejecutar ninguna herramienta hasta que: * el **email** esté confirmado (repetido y confirmado por el usuario), * y el **teléfono** esté confirmado (repetido y confirmado por el usuario). * Si el usuario duda o corrige un dato, el agente debe **actualizarlo y volver a confirmarlo** antes de continuar. ### Qué escribir en el Conversation Prompt (texto inventado y fácil de adaptar) **Objetivo del flujo:**\\ 1. Recoger datos básicos → 2) Confirmarlos → 3) Consultar CRM → 4) Si no existe, crear lead → 5) Continuar con la conversación. **Instrucciones claras para el agente (ejemplo):** * Durante la llamada, recopila y confirma estos datos: * **Nombre y apellido** * **Email** * **Teléfono** * **Motivo** (una frase corta) * Para confirmar: * Repite el email y pregunta: “¿Es correcto?” * Repite el teléfono y pregunta: “¿Es correcto?” * Solo cuando email y teléfono estén confirmados: * Ejecuta **Consultar\_Contacto\_CRM**. * Si el resultado indica que el contacto **existe**: * Dile al usuario: “Perfecto, ya veo tu ficha registrada. Vamos a continuar.” * No inventes detalles. Si el estado viene en el resultado, puedes mencionarlo de forma neutral. * Si el resultado indica que el contacto **no existe**: * Dile al usuario: “Perfecto, no te encuentro todavía. Te registro ahora y seguimos.” * Ejecuta **Crear\_Lead\_CRM** con los datos confirmados. * Después de crear, confirma: “Listo, ya estás registrado. Continuemos con el siguiente paso.” * Si la herramienta falla o no devuelve respuesta: * No digas información técnica. * Di: “No he podido comprobarlo ahora mismo. Vamos a continuar, y si hace falta lo revisamos al final.” * No repitas herramientas en bucle. ### Cómo se vería en una llamada (ejemplo de conversación) **Agente:** “Perfecto. Para ayudarte, necesito unos datos rápidos. ¿Cuál es tu nombre y apellido?”\ **Usuario:** “Laura Martín.”\ **Agente:** “Gracias, Laura. ¿Cuál es tu email?”\ **Usuario:** “[laura.martin@ejemplo.com](mailto:laura.martin@ejemplo.com)”\ **Agente:** “Perfecto. He entendido: laura punto martin arroba ejemplo punto com. ¿Es correcto?”\ **Usuario:** “Sí.”\ **Agente:** “Genial. ¿Cuál es tu teléfono?”\ **Usuario:** “Seis seis cinco, uno dos tres, cuatro cinco seis.”\ **Agente:** “Perfecto. Confirmo el teléfono: 665 123 456. ¿Es correcto?”\ **Usuario:** “Sí.”\ **Agente:** “Gracias. Un último dato: en una frase, ¿cuál es el motivo de tu llamada?”\ **Usuario:** “Quiero información sobre los planes.”\ **Agente:** “Perfecto. Voy a comprobar si ya estás registrada y seguimos.” (El agente ejecuta **Consultar\_Contacto\_CRM**) * **Si existe:**\ **Agente:** “Perfecto, ya veo tu ficha registrada. Vamos a continuar con la información sobre planes.” * **Si no existe:**\ **Agente:** “Perfecto, no te encuentro todavía. Te registro ahora y seguimos.” (El agente ejecuta **Crear\_Lead\_CRM**) **Agente:** “Listo, ya estás registrada. Ahora sí, vamos con la información sobre planes.” ### Reglas de seguridad del flujo (para evitar errores) * No ejecutes herramientas con datos sin confirmar. * No inventes resultados del CRM: solo usa lo que llegue como respuesta. * No repitas la herramienta varias veces si falla: continúa y ofrece revisarlo después. * No mezcles flujos: primero CRM (verificar/crear) y luego el resto del proceso. *** ## Ejemplo 2 — Enviar enlaces en el momento correcto (durante la llamada y al final) A continuación tienes un ejemplo completo (inventado) con dos herramientas: un enlace principal durante la llamada y un enlace de acceso al final. **Herramienta 1: Enviar\_Enlace\_Registro (Enlace A)**\ **Objetivo:** enviar el enlace principal donde el usuario completa todo el proceso principal.\ **Cuándo se usa:** durante la llamada, solo cuando el usuario confirma que quiere continuar y el email + teléfono están confirmados. **Enlace A completa (dentro del propio enlace):** 1. Registro inicial (datos obligatorios) 2. Verificación/confirmación de información 3. Selección de plan u opción 4. Configuración de pago (si aplica) 5. Aceptación de términos o firma (si aplica) 6. Carga de documentación (si aplica) 7. Confirmación final **Condiciones para ejecutar “Enviar\_Enlace\_Registro”:** * El usuario dice claramente que quiere continuar. * El email está confirmado (repetido y confirmado por el usuario). * El teléfono está confirmado (repetido y confirmado por el usuario). **Frase exacta después de enviar Enlace A (ejemplo inventado):** > “Abre el enlace que te acabamos de enviar y baja hasta la sección ‘Registro inicial’. Completa tus datos y dime cuando estés listo para continuar.” **Reglas durante la llamada (muy importante):** * No le pidas al usuario que salga del Enlace A para hacer pasos en otro sitio durante la llamada. * No le pidas iniciar sesión en un portal separado mientras está completando el proceso principal. * Guía al usuario paso a paso, siempre en el punto en el que se encuentre. *** **Herramienta 2: Enviar\_Enlace\_Portal (Enlace B)**\ **Objetivo:** enviar el enlace de acceso al portal seguro para revisar el progreso más tarde.\ **Cuándo se usa:** únicamente al final de la llamada. **Frases exactas después de enviar Enlace B (ejemplo inventado):** > “Aquí tienes el enlace para entrar a tu portal seguro.”\ > “También te enviamos correos con tus datos de acceso.”\ > “Si no los encuentras, usa el buscador del email y escribe el nombre de nuestra empresa para localizarlos.” **Cierre final (ejemplo inventado):** > “Gracias por tu tiempo. Si necesitas ayuda con cualquier paso, estamos disponibles para asistirte.” *** ## Paso 4 — Probar la herramienta antes de usarla en producción Antes de usar la herramienta con clientes, valida que: * La petición se ejecuta correctamente. * Los campos llegan con el nombre esperado (Identifier). * Los campos obligatorios (Required) están siempre presentes. * El endpoint responde de forma rápida y consistente. Una buena práctica es probar el webhook con una URL de inspección temporal (para ver qué llega) y luego con tu endpoint real. ### Checklist rápida (30 segundos) * La herramienta está creada y guardada en **Tools**. * La herramienta está asignada al agente en **AI Agents > tu agente > Tools**. * El **Conversation Prompt** indica claramente: * qué datos pedir, * cómo confirmarlos, * cuándo ejecutar la herramienta, * y qué decir justo después. *** ## Errores comunes y cómo solucionarlos | Problema | Causa probable | Solución | | ----------------------------------- | ----------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ | | La herramienta no se ejecuta | No está asignada al agente | Ve a **AI Agents > tu agente > Tools** y añádela | | No llega información al endpoint | Endpoint inaccesible o URL incorrecta | Verifica que la URL sea **HTTPS** y accesible públicamente | | Faltan campos | “Identifier / Required” mal definidos o el agente no los recopila | Revisa **Body parameters** y ajusta el **Conversation Prompt** para exigir y confirmar los datos | | Se ejecuta en el momento equivocado | El Conversation Prompt no define condiciones claras | Especifica reglas del tipo “solo al final”, “solo tras confirmar email y teléfono” | *** ## Consejo final Para conseguir un resultado estable: * Empieza con una herramienta simple. * Define pocos campos obligatorios al inicio. * En el Conversation Prompt, sé explícito con: * **condiciones de ejecución**, * **orden del flujo**, * **frases exactas** (si aplican), * **y prohibiciones** (qué no debe hacer el agente). # Strumenti Source: https://support.callin.io/Create-AI-Agent/Create-Tools-copied-3 Crea strumenti (webhook) in Callin e usali dal campo Conversation Prompt del tuo agente per inviare o consultare dati in tempo reale durante una chiamata. ## Panoramica Gli **strumenti** (webhook) permettono al tuo agente Callin di connettersi a sistemi esterni **in tempo reale** mentre conversa con un utente. Detto in modo semplice: uno strumento è un’**azione automatica** che l’agente può eseguire per **chiedere** o **inviare** informazioni a un altro sistema (per esempio, il tuo CRM) senza interrompere la conversazione. Con uno strumento, il tuo agente può: * **Inviare dati** che l’utente comunica durante la chiamata (per esempio: nome, email, telefono, motivo). * **Consultare dati** in un sistema esterno (per esempio: stato, disponibilità, verifica). * **Attivare automazioni** su piattaforme esterne (CRM, ticket, messaggistica, flussi, ecc.). In Callin, il funzionamento corretto segue sempre questo ordine: 1. **Creare lo strumento** nella sezione **Tools**. 2. **Assegnare lo strumento** all’agente in **AI Agents**. 3. **Indicare nel campo Conversation Prompt** quando deve eseguirsi e cosa deve fare l’agente con il risultato. Se manca uno di questi 3 passaggi, lo strumento non verrà eseguito come ti aspetti. *** ## Prima di iniziare (concetti in 60 secondi) * **Tool / Strumento**: connessione che permette all’agente di “parlare” con un altro sistema (per esempio, un CRM). * **URL**: l’indirizzo a cui Callin invia la richiesta. * **GET**: si usa per **consultare** un’informazione (“Questo contatto esiste?”). * **POST**: si usa per **inviare** un’informazione (“Crea questo lead con questi dati.”). * **Body parameters**: i **dati** che l’agente invierà (email, telefono, nome, ecc.). * **Required**: campi **obbligatori**. Se ne manca uno, il risultato può essere incompleto o il flusso può fallire. > Se il tuo utente non è tecnico, tieni a mente questa idea: **lo strumento crea la connessione**, e il **Conversation Prompt decide quando usarlo e con quali dati**. *** ## Passo 1 — Creare uno strumento (webhook) Per creare uno strumento in Callin: 1. Entra in **Tools** nel pannello di Callin. 2. Clicca su **+ Add Tool**. 3. Compila i campi principali: * **Name**\ Usa un nome corto, chiaro e stabile. Consiglio: **verbo + obiettivo**.\ Esempi: `verifica-contatto-crm`, `crea-lead-crm`, `invia-link-registrazione`. * **Description**\ Spiega **a cosa serve** e soprattutto **quando va usato** (in quale momento della chiamata).\ Esempio: “Verificare se il contatto esiste nel CRM solo dopo aver confermato email e telefono.” * **Method** * Usa **GET** se devi **consultare** informazioni. * Usa **POST** se devi **inviare** informazioni (il caso più comune quando l’agente raccoglie dati e li invia). * **URL**\ Incolla l’URL HTTPS della tua API o il webhook della tua piattaforma esterna. > Assicurati che l’URL sia **HTTPS** e accessibile pubblicamente. Se l’endpoint non è accessibile, lo strumento non funzionerà. ### Configurare i “Body parameters” (se usi POST) Se lo strumento invia informazioni (POST), definisci esattamente quali dati invierà: 1. Vai su **Body parameters**. 2. Clicca su **Add property**. 3. Configura ogni campo: * **Type**: il tipo di dato (testo, numero, vero/falso, ecc.). * **Identifier**: il nome esatto del campo atteso dal tuo endpoint (per esempio: `email`, `telefono`, `nome_completo`). * **Required**: attivalo se il campo è obbligatorio. * **Description**: spiega cosa rappresenta e il formato atteso (per esempio: “Telefono in formato internazionale” o “Email valida”). > Consiglio pratico: se contrassegni un campo come **Required**, il tuo agente deve essere obbligato (tramite il Conversation Prompt) a **chiederlo e confermarlo** prima di eseguire lo strumento. Altrimenti, il webhook riceverà dati incompleti o il flusso fallirà. ### Header e autenticazione (se applicabile) Se il tuo endpoint richiede autenticazione (per esempio, un token o una chiave), dovrai configurarla seguendo esattamente i requisiti della tua API (quali header servono e con quali valori). 4. Clicca su **Save** per salvare lo strumento. *** ## Passo 2 — Assegnare lo strumento a un agente Creare lo strumento non è sufficiente. Devi assegnarlo all’agente: 1. Vai su **AI Agents**. 2. Seleziona l’agente che vuoi configurare. 3. Nell’editor dell’agente, scorri fino alla sezione **Tools**. 4. Clicca su **+ Add Tool**. 5. Seleziona lo strumento e salva. **Controllo rapido:**\ Se lo strumento appare nell’elenco dell’agente, è assegnato correttamente. Se non appare, l’agente non potrà eseguirlo. *** ## Passo 3 — Indicare come usare lo strumento nel “Conversation Prompt” Questo è il passaggio più importante. L’agente eseguirà lo strumento solo se il **Conversation Prompt** gli indica chiaramente: * **Quali dati deve raccogliere** prima di eseguirlo (campi obbligatori). * **Come confermare quei dati** (per ridurre errori). * **Quando** deve eseguirlo (momento esatto della chiamata). * **Cosa deve dire subito dopo** averlo eseguito (incluse frasi esatte se il tuo processo lo richiede). * **Cosa NON deve fare** (per evitare di mischiare flussi o agire troppo presto). ### Regola chiave (per utenti non tecnici) Se non dici all’agente **“quando”** e **“a quali condizioni”** usare lo strumento, l’agente potrebbe: * usarlo troppo presto, * usarlo con dati incompleti, * oppure non usarlo mai. *** ## Esempio 1 — Connettersi a un CRM in tempo reale (verifica + creazione) Questo esempio copre un caso molto comune: l’agente parla con un utente e, **prima di continuare**, controlla nel CRM se il contatto esiste già. Se non esiste, crea un lead e continua la chiamata. ### Strumenti usati in questo esempio **Strumento 1: Verifica\_Contatto\_CRM**\ **Obiettivo:** controllare se il contatto esiste già nel CRM.\ **Quando si usa:** subito dopo aver confermato **email + telefono**.\ **Risultato atteso:** “trovato / non trovato” e, se trovato, dati di base (per esempio: nome e stato). **Strumento 2: Crea\_Lead\_CRM**\ **Obiettivo:** creare un lead se il contatto non esiste.\ **Quando si usa:** solo se la verifica precedente restituisce “non trovato”.\ **Dati minimi consigliati:** nome, email, telefono, motivo. ### Condizioni per eseguire gli strumenti (molto importante) * L’agente **non deve** eseguire nessuno strumento finché: * l’**email** non è confermata (ripetuta e confermata dall’utente), * e il **telefono** non è confermato (ripetuto e confermato dall’utente). * Se l’utente esita o corregge un dato, l’agente deve **aggiornarlo e riconfermarlo** prima di continuare. ### Cosa scrivere nel Conversation Prompt (testo inventato e facile da adattare) **Obiettivo del flusso:**\\ 1. Raccogliere dati base → 2) Confermarli → 3) Verificare nel CRM → 4) Se non trovato, creare lead → 5) Continuare la conversazione. **Istruzioni chiare per l’agente (esempio):** * Durante la chiamata, raccogli e conferma questi dati: * **Nome e cognome** * **Email** * **Telefono** * **Motivo** (una frase breve) * Per confermare: * Ripeti l’email e chiedi: “È corretto?” * Ripeti il telefono e chiedi: “È corretto?” * Solo quando email e telefono sono confermati: * Esegui **Verifica\_Contatto\_CRM**. * Se il risultato indica che il contatto **esiste**: * Di’ all’utente: “Perfetto, vedo già la tua scheda. Continuiamo.” * Non inventare dettagli. Se lo stato arriva nel risultato, puoi citarlo in modo neutro. * Se il risultato indica che il contatto **non esiste**: * Di’ all’utente: “Perfetto, non ti trovo ancora. Ti registro ora e continuiamo.” * Esegui **Crea\_Lead\_CRM** con i dati confermati. * Dopo la creazione, conferma: “Fatto, sei registrato. Continuiamo con il prossimo passo.” * Se lo strumento fallisce o non restituisce risposta: * Non dire informazioni tecniche. * Di’: “Non sono riuscito a verificarlo in questo momento. Continuiamo e, se serve, lo rivediamo alla fine.” * Non ripetere gli strumenti in loop. ### Come apparirebbe in una chiamata (esempio di conversazione) **Agente:** “Perfetto. Per aiutarti, ho bisogno di alcuni dati rapidi. Qual è il tuo nome e cognome?”\ **Utente:** “Laura Martin.”\ **Agente:** “Grazie, Laura. Qual è la tua email?”\ **Utente:** “[laura.martin@esempio.com](mailto:laura.martin@esempio.com)”\ **Agente:** “Perfetto. Ho capito: laura punto martin chiocciola esempio punto com. È corretto?”\ **Utente:** “Sì.”\ **Agente:** “Ottimo. Qual è il tuo numero di telefono?”\ **Utente:** “Sei sei cinque, uno due tre, quattro cinque sei.”\ **Agente:** “Perfetto. Confermo il telefono: 665 123 456. È corretto?”\ **Utente:** “Sì.”\ **Agente:** “Grazie. Un’ultima cosa: in una frase, qual è il motivo della chiamata?”\ **Utente:** “Voglio informazioni sui piani.”\ **Agente:** “Perfetto. Controllo se sei già registrata e poi continuiamo.” (L’agente esegue **Verifica\_Contatto\_CRM**) * **Se trovato:**\ **Agente:** “Perfetto, vedo già la tua scheda. Continuiamo con le informazioni sui piani.” * **Se non trovato:**\ **Agente:** “Perfetto, non ti trovo ancora. Ti registro ora e continuiamo.” (L’agente esegue **Crea\_Lead\_CRM**) **Agente:** “Fatto, sei registrata. Ora sì: passiamo alle informazioni sui piani.” ### Regole di sicurezza del flusso (per evitare errori) * Non eseguire strumenti con dati non confermati. * Non inventare risultati del CRM: usa solo ciò che arriva come risposta. * Non riprovare lo strumento più volte se fallisce: continua e proponi di rivederlo dopo. * Non mischiare flussi: prima CRM (verifica/creazione), poi il resto del processo. *** ## Esempio 2 — Inviare link nel momento giusto (durante la chiamata e alla fine) Di seguito trovi un esempio completo (inventato) con due strumenti: un link principale durante la chiamata e un link di accesso alla fine. **Strumento 1: Invia\_Link\_Registrazione (Link A)**\ **Obiettivo:** inviare il link principale in cui l’utente completa tutto il processo principale.\ **Quando si usa:** durante la chiamata, solo quando l’utente conferma di voler continuare e email + telefono sono confermati. **Il Link A include (dentro il link stesso):** 1. Registrazione iniziale (dati obbligatori) 2. Verifica/conferma delle informazioni 3. Selezione del piano o opzione 4. Configurazione del pagamento (se applicabile) 5. Accettazione termini o firma (se applicabile) 6. Caricamento documenti (se applicabile) 7. Conferma finale **Condizioni per eseguire “Invia\_Link\_Registrazione”:** * L’utente dice chiaramente che vuole continuare. * L’email è confermata (ripetuta e confermata dall’utente). * Il telefono è confermato (ripetuto e confermato dall’utente). **Frase esatta dopo aver inviato il Link A (esempio inventato):** > “Apri il link che ti abbiamo appena inviato e scorri fino alla sezione ‘Registrazione iniziale’. Compila i tuoi dati e dimmi quando sei pronto per continuare.” **Regole durante la chiamata (molto importante):** * Non chiedere all’utente di uscire dal Link A per fare passaggi altrove durante la chiamata. * Non chiedere di accedere a un portale separato mentre sta completando il processo principale. * Guida l’utente passo dopo passo, sempre dal punto in cui si trova. *** **Strumento 2: Invia\_Link\_Portal (Link B)**\ **Obiettivo:** inviare il link di accesso al portale sicuro per controllare lo stato più tardi.\ **Quando si usa:** solo alla fine della chiamata. **Frasi esatte dopo aver inviato il Link B (esempio inventato):** > “Ecco il link per accedere al tuo portale sicuro.”\ > “Ti abbiamo anche inviato email con i dati di accesso.”\ > “Se non le trovi, usa la ricerca nelle email e scrivi il nome della nostra azienda per localizzarle.” **Chiusura finale (esempio inventato):** > “Grazie per il tuo tempo. Se hai bisogno di aiuto in qualsiasi passaggio, siamo disponibili ad assisterti.” *** ## Passo 4 — Testare lo strumento prima di usarlo in produzione Prima di usare lo strumento con i clienti, verifica che: * La richiesta venga eseguita correttamente. * I campi arrivino con il nome previsto (Identifier). * I campi obbligatori (Required) siano sempre presenti. * L’endpoint risponda in modo rapido e coerente. Una buona pratica è testare il webhook con un URL di ispezione temporaneo (per vedere cosa arriva) e poi con il tuo endpoint reale. ### Checklist rapida (30 secondi) * Lo strumento è creato e salvato in **Tools**. * Lo strumento è assegnato all’agente in **AI Agents > il tuo agente > Tools**. * Il **Conversation Prompt** specifica chiaramente: * quali dati chiedere, * come confermarli, * quando eseguire lo strumento, * e cosa dire subito dopo. *** ## Errori comuni e come risolverli | Problema | Causa probabile | Soluzione | | ------------------------------- | ----------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | | Lo strumento non viene eseguito | Non è assegnato all’agente | Vai su **AI Agents > il tuo agente > Tools** e aggiungilo | | Non arriva nulla all’endpoint | Endpoint non accessibile o URL errato | Verifica che l’URL sia **HTTPS** e accessibile pubblicamente | | Mancano campi | “Identifier / Required” definiti male o l’agente non li raccoglie | Controlla **Body parameters** e adatta il **Conversation Prompt** per richiedere e confermare i dati | | Si esegue nel momento sbagliato | Il Conversation Prompt non definisce condizioni chiare | Specifica regole tipo “solo alla fine”, “solo dopo conferma di email e telefono” | *** ## Consiglio finale Per ottenere un risultato stabile: * Inizia con uno strumento semplice. * Definisci pochi campi obbligatori all’inizio. * Nel Conversation Prompt, sii esplicito su: * **condizioni di esecuzione**, * **ordine del flusso**, * **frasi esatte** (se applicabili), * **e divieti** (cosa l’agente non deve fare). # Outils Source: https://support.callin.io/Create-AI-Agent/Create-Tools-copied-4 Créez des outils (webhooks) dans Callin et utilisez-les depuis le champ Conversation Prompt de votre agent pour envoyer ou consulter des données en temps réel pendant un appel. ## Vue d’ensemble Les **outils** (webhooks) permettent à votre agent Callin de se connecter à des systèmes externes **en temps réel** pendant qu’il converse avec un utilisateur. Dit simplement : un outil est une **action automatique** que l’agent peut exécuter pour **demander** ou **envoyer** des informations à un autre système (par exemple, votre CRM) sans interrompre la conversation. Avec un outil, votre agent peut : * **Envoyer des données** dictées par l’utilisateur pendant l’appel (par exemple : nom, email, téléphone, motif). * **Consulter des données** dans un système externe (par exemple : statut, disponibilité, vérification). * **Déclencher des automatisations** sur des plateformes externes (CRM, tickets, messagerie, workflows, etc.). Dans Callin, le bon fonctionnement suit toujours cet ordre : 1. **Créer l’outil** dans la section **Tools**. 2. **Assigner l’outil** à l’agent dans **AI Agents**. 3. **Indiquer dans le champ Conversation Prompt** quand l’outil doit s’exécuter et ce que l’agent doit faire avec le résultat. S’il manque l’une de ces 3 étapes, l’outil ne s’exécutera pas comme prévu. *** ## Avant de commencer (concepts en 60 secondes) * **Outil / Tool** : connexion qui permet à l’agent de “parler” à un autre système (par exemple, un CRM). * **URL** : l’adresse à laquelle Callin envoie la requête. * **GET** : utilisé pour **consulter** une information (“Ce contact existe-t-il ?”). * **POST** : utilisé pour **envoyer** une information (“Créez ce lead avec ces données.”). * **Body parameters** : les **données** que l’agent enverra (email, téléphone, nom, etc.). * **Required** : champs **obligatoires**. S’il en manque un, le résultat peut être incomplet ou le flux peut échouer. > Si votre utilisateur n’est pas technique, retenez cette idée : **l’outil crée la connexion**, et le **Conversation Prompt** décide quand il est utilisé et avec quelles données. *** ## Étape 1 — Créer un outil (webhook) Pour créer un outil dans Callin : 1. Allez dans **Tools** dans le tableau de bord Callin. 2. Cliquez sur **+ Add Tool**. 3. Remplissez les champs principaux : * **Name**\ Utilisez un nom court, clair et stable. Recommandation : **verbe + objectif**.\ Exemples : `consulter-contact-crm`, `creer-lead-crm`, `envoyer-lien-inscription`. * **Description**\ Expliquez **à quoi ça sert** et surtout **quand l’utiliser** (à quel moment dans l’appel).\ Exemple : “Vérifier si le contact existe dans le CRM uniquement après confirmation de l’email et du téléphone.” * **Method** * Utilisez **GET** si vous allez **consulter** des informations. * Utilisez **POST** si vous allez **envoyer** des informations (le plus courant quand l’agent collecte des données et les envoie). * **URL**\ Collez l’URL HTTPS de votre API ou le webhook de votre plateforme externe. > Assurez-vous que l’URL est **HTTPS** et accessible publiquement. Si l’endpoint n’est pas accessible, l’outil ne fonctionnera pas. ### Configurer “Body parameters” (si vous utilisez POST) Si votre outil envoie des informations (POST), définissez exactement quelles données il enverra : 1. Allez dans **Body parameters**. 2. Cliquez sur **Add property**. 3. Configurez chaque champ : * **Type** : le type de donnée (texte, nombre, vrai/faux, etc.). * **Identifier** : le nom exact du champ attendu par votre endpoint (par exemple : `email`, `telephone`, `nom_complet`). * **Required** : activez-le si le champ est obligatoire. * **Description** : expliquez ce que cela représente et le format attendu (par exemple : “Téléphone au format international” ou “Email valide”). > Recommandation pratique : si vous marquez un champ comme **Required**, votre agent doit être obligé (via le Conversation Prompt) de **le demander et de le confirmer** avant d’exécuter l’outil. Sinon, le webhook recevra des données incomplètes ou le flux échouera. ### En-têtes et authentification (si applicable) Si votre endpoint nécessite une authentification (par exemple, un token ou une clé), vous devrez la configurer selon les exigences exactes de votre API (quels en-têtes et quelles valeurs). 4. Cliquez sur **Save** pour enregistrer l’outil. *** ## Étape 2 — Assigner l’outil à un agent Créer l’outil ne suffit pas. Vous devez l’assigner à l’agent : 1. Allez dans **AI Agents**. 2. Sélectionnez l’agent que vous voulez configurer. 3. Dans l’éditeur de l’agent, descendez jusqu’à la section **Tools**. 4. Cliquez sur **+ Add Tool**. 5. Sélectionnez l’outil et enregistrez. **Vérification rapide :**\ Si l’outil apparaît dans la liste de l’agent, il est bien assigné. S’il n’apparaît pas, l’agent ne pourra pas l’exécuter. *** ## Étape 3 — Indiquer comment utiliser l’outil dans “Conversation Prompt” C’est l’étape la plus importante. L’agent n’exécutera l’outil que si le **Conversation Prompt** lui indique clairement : * **Quelles données il doit collecter** avant d’exécuter l’outil (champs obligatoires). * **Comment confirmer ces données** (pour réduire les erreurs). * **Quand** exécuter l’outil (moment exact dans l’appel). * **Que dire juste après** l’exécution (y compris des phrases exactes si votre processus l’exige). * **Ce qu’il ne doit PAS faire** (pour éviter de mélanger les flux ou d’agir trop tôt). ### Règle clé (pour les utilisateurs non techniques) Si vous ne dites pas à l’agent **“quand”** et **“dans quelles conditions”** utiliser l’outil, l’agent peut : * l’utiliser trop tôt, * l’utiliser avec des données incomplètes, * ou ne jamais l’utiliser. *** ## Exemple 1 — Se connecter à un CRM en temps réel (consultation + création) Cet exemple correspond à un cas très courant : l’agent parle avec un utilisateur et, **avant de continuer**, vérifie dans le CRM si le contact existe déjà. S’il n’existe pas, il le crée comme lead et continue l’appel. ### Outils utilisés dans cet exemple **Outil 1 : Consulter\_Contact\_CRM**\ **Objectif :** vérifier si le contact existe déjà dans le CRM.\ **Quand l’utiliser :** juste après confirmation de **l’email + du téléphone**.\ **Résultat attendu :** “trouvé / non trouvé” et, si trouvé, des informations de base (par exemple : nom et statut). **Outil 2 : Creer\_Lead\_CRM**\ **Objectif :** créer un lead si le contact n’existe pas.\ **Quand l’utiliser :** uniquement si la consultation précédente renvoie “non trouvé”.\ **Données minimales recommandées :** nom, email, téléphone, motif. ### Conditions pour exécuter les outils (très important) * L’agent **ne doit exécuter aucun outil** tant que : * l’**email** n’est pas confirmé (répété et confirmé par l’utilisateur), * et le **téléphone** n’est pas confirmé (répété et confirmé par l’utilisateur). * Si l’utilisateur hésite ou corrige une information, l’agent doit **la mettre à jour et confirmer à nouveau** avant de continuer. ### Qu’écrire dans le Conversation Prompt (texte inventé et facile à adapter) **Objectif du flux :**\\ 1. Collecter les informations → 2) Les confirmer → 3) Consulter le CRM → 4) Si non trouvé, créer le lead → 5) Continuer la conversation. **Instructions claires pour l’agent (exemple) :** * Pendant l’appel, collecte et confirme ces informations : * **Prénom et nom** * **Email** * **Téléphone** * **Motif** (une phrase courte) * Pour confirmer : * Répète l’email et demande : “Est-ce correct ?” * Répète le téléphone et demande : “Est-ce correct ?” * Uniquement lorsque l’email et le téléphone sont confirmés : * Exécute **Consulter\_Contact\_CRM**. * Si le résultat indique que le contact **existe** : * Dis à l’utilisateur : “Parfait, je vois déjà votre fiche. On continue.” * N’invente pas de détails. Si le statut est présent dans le résultat, tu peux le mentionner de façon neutre. * Si le résultat indique que le contact **n’existe pas** : * Dis à l’utilisateur : “Parfait, je ne vous trouve pas encore. Je vous enregistre maintenant et on continue.” * Exécute **Creer\_Lead\_CRM** avec les informations confirmées. * Après création, confirme : “C’est bon, vous êtes enregistré. On continue avec l’étape suivante.” * Si l’outil échoue ou ne renvoie pas de réponse : * Ne donne pas d’informations techniques. * Dis : “Je n’ai pas pu vérifier tout de suite. On continue, et si besoin on le reverra à la fin.” * Ne répète pas les outils en boucle. ### À quoi cela ressemble pendant un appel (exemple de conversation) **Agent :** “Parfait. Pour vous aider, j’ai juste besoin de quelques informations rapides. Quel est votre prénom et votre nom ?”\ **Utilisateur :** “Laura Martin.”\ **Agent :** “Merci, Laura. Quel est votre email ?”\ **Utilisateur :** “[laura.martin@exemple.com](mailto:laura.martin@exemple.com)”\ **Agent :** “Parfait. J’ai compris : laura point martin arobase exemple point com. Est-ce correct ?”\ **Utilisateur :** “Oui.”\ **Agent :** “Très bien. Quel est votre numéro de téléphone ?”\ **Utilisateur :** “Six six cinq, un deux trois, quatre cinq six.”\ **Agent :** “Parfait. Je confirme le téléphone : 665 123 456. Est-ce correct ?”\ **Utilisateur :** “Oui.”\ **Agent :** “Merci. Dernière question : en une phrase, quel est le motif de votre appel ?”\ **Utilisateur :** “Je veux des infos sur les offres.”\ **Agent :** “Parfait. Je vais vérifier si vous êtes déjà enregistrée, puis on continue.” (L’agent exécute **Consulter\_Contact\_CRM**) * **Si trouvé :**\ **Agent :** “Parfait, je vois déjà votre fiche. On continue avec les informations sur les offres.” * **Si non trouvé :**\ **Agent :** “Parfait, je ne vous trouve pas encore. Je vous enregistre maintenant et on continue.” (L’agent exécute **Creer\_Lead\_CRM**) **Agent :** “C’est bon, vous êtes enregistré. Maintenant, passons aux informations sur les offres.” ### Règles de sécurité du flux (pour éviter les erreurs) * N’exécute pas d’outils avec des informations non confirmées. * N’invente pas de résultats du CRM : utilise uniquement ce qui revient dans la réponse. * Ne relance pas l’outil plusieurs fois s’il échoue : continue et propose de revoir plus tard. * Ne mélange pas les flux : d’abord CRM (vérifier/créer), ensuite le reste du processus. *** ## Exemple 2 — Envoyer des liens au bon moment (pendant l’appel et à la fin) Voici un exemple complet (inventé) avec deux outils : un lien principal pendant l’appel et un lien d’accès à la fin. **Outil 1 : Envoyer\_Lien\_Inscription (Lien A)**\ **Objectif :** envoyer le lien principal où l’utilisateur complète tout le processus principal.\ **Quand l’utiliser :** pendant l’appel, uniquement lorsque l’utilisateur confirme vouloir continuer et que l’email + le téléphone sont confirmés. **Le lien A inclut (dans le lien lui-même) :** 1. Inscription initiale (informations obligatoires) 2. Vérification/confirmation des informations 3. Choix d’un plan ou d’une option 4. Configuration du paiement (si applicable) 5. Acceptation des conditions ou signature (si applicable) 6. Téléversement de documents (si applicable) 7. Confirmation finale **Conditions pour exécuter “Envoyer\_Lien\_Inscription” :** * L’utilisateur dit clairement qu’il veut continuer. * L’email est confirmé (répété et confirmé par l’utilisateur). * Le téléphone est confirmé (répété et confirmé par l’utilisateur). **Phrase exacte après l’envoi du lien A (exemple inventé) :** > “Ouvrez le lien que nous venons de vous envoyer et descendez jusqu’à la section ‘Inscription initiale’. Complétez vos informations et dites-moi quand vous êtes prêt à continuer.” **Règles pendant l’appel (très important) :** * Ne demande pas à l’utilisateur de quitter le lien A pour faire des étapes ailleurs pendant l’appel. * Ne lui demande pas de se connecter à un portail séparé pendant qu’il complète le processus principal. * Guide l’utilisateur étape par étape, toujours depuis l’endroit où il se trouve. *** **Outil 2 : Envoyer\_Lien\_Portal (Lien B)**\ **Objectif :** envoyer le lien d’accès au portail sécurisé pour consulter l’avancement plus tard.\ **Quand l’utiliser :** uniquement à la fin de l’appel. **Phrases exactes après l’envoi du lien B (exemple inventé) :** > “Voici le lien pour accéder à votre portail sécurisé.”\ > “Nous vous avons aussi envoyé des emails avec vos identifiants de connexion.”\ > “Si vous ne les trouvez pas, utilisez la recherche dans votre email et tapez le nom de notre entreprise pour les localiser.” **Clôture finale (exemple inventé) :** > “Merci pour votre temps. Si vous avez besoin d’aide à une étape quelconque, nous sommes disponibles pour vous assister.” *** ## Étape 4 — Tester l’outil avant de l’utiliser en production Avant d’utiliser l’outil avec des clients, vérifiez que : * La requête s’exécute correctement. * Les champs arrivent avec le nom attendu (Identifier). * Les champs obligatoires (Required) sont toujours présents. * L’endpoint répond rapidement et de manière cohérente. Une bonne pratique consiste à tester le webhook avec une URL d’inspection temporaire (pour voir ce qui arrive) puis avec votre endpoint réel. ### Checklist rapide (30 secondes) * L’outil est créé et enregistré dans **Tools**. * L’outil est assigné à l’agent dans **AI Agents > votre agent > Tools**. * Le **Conversation Prompt** précise clairement : * quelles informations demander, * comment les confirmer, * quand exécuter l’outil, * et quoi dire juste après. *** ## Erreurs courantes et solutions | Problème | Cause probable | Solution | | ---------------------------------------- | ------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------ | | L’outil ne s’exécute pas | Il n’est pas assigné à l’agent | Allez dans **AI Agents > votre agent > Tools** et ajoutez-le | | Aucune information n’arrive à l’endpoint | Endpoint inaccessible ou URL incorrecte | Vérifiez que l’URL est **HTTPS** et accessible publiquement | | Champs manquants | “Identifier / Required” mal définis ou l’agent ne les collecte pas | Vérifiez **Body parameters** et ajustez le **Conversation Prompt** pour exiger et confirmer les données | | Exécution au mauvais moment | Le Conversation Prompt ne définit pas de conditions claires | Spécifiez des règles comme “uniquement à la fin”, “uniquement après confirmation de l’email et du téléphone” | *** ## Conseil final Pour obtenir un résultat stable : * Commencez par un outil simple. * Définissez peu de champs obligatoires au début. * Dans le Conversation Prompt, soyez explicite sur : * **les conditions d’exécution**, * **l’ordre du flux**, * **les phrases exactes** (si applicable), * **et les interdictions** (ce que l’agent ne doit pas faire). # Google Calendar Source: https://support.callin.io/Create-AI-Agent/Google-Calendar A step-by-step guide to connect Google Calendar in Callin.io, create an event template (availability + duration + reminders), and attach it to an AI Agent so it can book appointments during calls—without adding conflicting scheduling rules to your prompt. ## What you’ll set up (and why it matters) Google Calendar scheduling in Callin.io is designed to be reliable and consistent. To achieve that, the setup is split into two parts: 1. **Google Calendar integration setup**\ You connect your Google account and create an **Event Template**. This template is where you define the booking rules (days available, appointment duration, reminders, and conflict rules). 2. **AI Agent setup (Call Action)**\ You enable **Schedule Appointment** inside your agent and select the template you created. > **Important:** Your booking rules should live in the **Event Template**, not in the agent prompt. Avoid adding instructions like “Only Monday to Friday” or “Only between 9am and 5pm” inside the prompt—those rules can conflict with the platform’s built-in scheduling logic once Google Calendar is connected. ## Open the Google Calendar integration Use this direct link to open the Google Calendar integration page: [**click here**](https://app.callin.io/actions/google-calendar).Screenshot: This is the Google Calendar integration area where you connect your account, choose a calendar, and manage event templates.
> **Tip:** If your UI looks slightly different, that’s normal—some elements can vary by account or plan. ## Step 1: Connect your Google Account 1. On the Google Calendar integration page, click **Connect Google Account**. 2. A Google sign-in window opens. Choose the Google account you want to use for bookings. 3. Approve the permissions screen so Callin.io can create events and check availability. Once connected, you’ll typically see: * Your Google account displayed in the left panel * A list of calendars you can select * A **Disconnect Account** option (use it if you connected the wrong account) > **Important:** Use a calendar that represents your real availability. If your Google Calendar is always “busy” (or always “free”), the booking experience won’t match reality. ## Step 2: Choose the calendar where appointments should be created In the left panel, select the calendar you want bookings to go into. Examples: * A service business might use a calendar named “Appointments” * A sales team might use “Discovery Calls” * A clinic might use “Consultations” Why this selection matters: * Your template is built **for a specific calendar** * The agent will book into the calendar/template you assign later > **Tip:** If you have multiple calendars (for different teams or services), you can create different templates per calendar and assign the right one to each AI Agent. ## Step 3: Create an Event Template (this is where scheduling rules live) Before attaching scheduling to an AI Agent, you must create at least one **Event Template**. This template defines: * How long appointments are * How reminders work * Whether overlapping bookings are allowed * How conflicts are handled * Which days are available for bookings (Working Hours) To create one: 1. In the **Event Templates** section, click **Create Event Template**. 2. Fill out the fields (details below). 3. Click **Save**.Screenshot: The Event Template editor where you define duration, reminders, conflict rules, and working days.
### Field-by-field explanation (with practical examples) | Field | What it controls | Example you can copy | | ----------------------- | ---------------------------------------------------------------------- | ------------------------------------------ | | **Name** | The label for this appointment type (what you’ll recognize later) | “30-min Intro Call” | | **Description** | Helps your team understand what the appointment is for | “Quick intro + qualify needs + next steps” | | **Slot Duration** | The length of each appointment in minutes | 30 | | **Reminder Minutes** | How many minutes before the appointment the reminder is sent | 15 | | **Reminder Type** | The reminder channel (options may vary) | Email | | **Allow Event Overlap** | Whether the system can book more than one appointment at the same time | No | | **Conflict Handling** | What happens when something overlaps | Block overlapping events | | **Working Hours** | Which days are eligible for booking | Enable Monday–Friday | > **Common mistake:** Leaving **Working Hours** with no days selected. The template won’t be usable until at least one day is enabled. ### A complete example template (recommended starting point) If you want a safe default: * **Name:** “Discovery Call (30 min)” * **Description:** “First call to understand needs and confirm next steps” * **Slot Duration:** 30 * **Reminder Minutes:** 15 * **Reminder Type:** Email * **Allow Event Overlap:** No * **Conflict Handling:** Block overlapping events * **Working Hours:** Monday–Friday This setup prevents double-bookings and gives a clean, predictable scheduling experience. ## Step 4: Attach Google Calendar scheduling to an AI Agent (Call Action) After you have: * Connected a Google account, and * Created an Event Template, You can now enable booking inside an AI Agent. 1. Go to **AI Agents** in the left menu. 2. Open the agent you want to configure and click **Edit**. 3. Go to the **Call Action** tab. 4. Turn on **Schedule Appointment**. 5. Select **Google Calendar** as the provider. 6. Click the **settings icon** (gear) to open configuration and select the template you created. 7. Click **Save**.Screenshot: Inside the agent’s Call Action settings, enable scheduling and choose Google Calendar as the booking provider.
> **Important:** For best results, ensure the agent’s timezone matches your calendar’s timezone. A mismatch can cause “wrong time” suggestions. ## How booking should work during a call (recommended conversation flow) Once everything is connected, the best experience is when the agent follows a simple, human flow: 1. **Confirm intent**\ “Sure—do you want to book an appointment now?” 2. **Collect the minimum required details**\ Ask for: * Full name * Phone number\ (Optionally: a short reason for the appointment, if relevant.) 3. **Offer availability and confirm**\ The agent should propose times it can book (based on your template + calendar availability), then confirm the chosen slot. 4. **Book and confirm details**\ The agent books the event and repeats: * Date * Time * Duration * What the appointment is for ### Example (what “good” sounds like) * Caller: “Can I book a time for a consultation?” * Agent: “Yes. What’s your full name and the best phone number for the appointment?” * Caller: “Jordan Lee, +1 555-010-2040.” * Agent: “Thanks. Do you prefer earlier in the day or later? I can book a 30-minute consultation.” * Caller: “Later is better.” * Agent: “Great—does Thursday at 4:00 PM work?” * Caller: “Yes.” * Agent: “Perfect. You’re booked for Thursday at 4:00 PM for 30 minutes. You’ll also receive a reminder before the appointment.” > **Tip:** Keep the prompt focused on **collecting details and confirming**. Let the template handle the scheduling rules. ## Prompt rules: what to include (and what to avoid) ### What you should include in the prompt Your prompt should instruct the agent to: * Ask for name and phone number before booking * Confirm the appointment purpose briefly (one sentence) * Confirm the selected time clearly before finalizing * Confirm booking details at the end A practical prompt instruction (written as plain guidance) could look like: * “When the caller wants to book, ask for their full name and phone number first. Then suggest available times and confirm the chosen time. After booking, repeat the date, time, and duration to confirm.” ### What you should NOT include in the prompt Avoid instructions that duplicate or override the Event Template, such as: * “Only book Monday to Friday” * “Only book between 9am and 5pm” * “Never book same-day appointments” * “Only allow 1 appointment per day” Those rules should be configured in the **Event Template** (Working Hours, conflict rules, overlap rules). Keeping the prompt clean prevents conflicts and improves booking accuracy. > **Important:** Think of it this way:\ > **Template = rules and availability**\ > **Prompt = conversation and data collection** ## Best LLM for scheduling: Gemini 2.5 Flash (recommended) For scheduling accuracy, Callin.io works best with **Gemini 2.5 Flash**. > **Tip:** If scheduling fails (wrong times, missed availability, confusion), switch the agent’s LLM to **Gemini 2.5 Flash**, save, and test again. ## Troubleshooting checklist (quick fixes) ### “I connected Google Calendar but I don’t see my calendar” * Click **Sync** on the Google Calendar page. * Confirm you connected the correct Google account. ### “It says no availability” * Check **Working Hours** in your Event Template (at least one day must be enabled). * Confirm your Google Calendar isn’t fully blocked with busy events. ### “The agent books at the wrong time” * Verify the agent timezone matches the calendar timezone. * If the behavior is inconsistent, switch to **Gemini 2.5 Flash**. ### “Double bookings happen” * Set **Allow Event Overlap** to **No**. * Use a conflict option that blocks overlapping events. # Google calendar Source: https://support.callin.io/Create-AI-Agent/Google-Calendar-copied-1 Schritt-für-Schritt-Anleitung zum Verbinden von Google Calendar in Callin.io, zum Erstellen einer Event-Vorlage (Verfügbarkeit + Dauer + Erinnerungen) und zum Zuweisen an einen AI Agent, damit Termine während Anrufen gebucht werden können—ohne im Prompt widersprüchliche Zeitregeln zu hinterlegen. ## Was Sie einrichten (und warum das wichtig ist) Die Terminbuchung mit Google Calendar in Callin.io ist darauf ausgelegt, zuverlässig und konsistent zu funktionieren. Deshalb ist die Einrichtung in zwei Teile aufgeteilt: 1. **Einrichtung der Google-Calendar-Integration**\ Sie verbinden Ihr Google-Konto und erstellen ein **Event Template**. In dieser Vorlage definieren Sie die Buchungsregeln (verfügbare Tage, Dauer, Erinnerungen und Konfliktregeln). 2. **Einrichtung des AI Agent (Call Action)**\ Sie aktivieren **Schedule Appointment** im Agenten und wählen die erstellte Vorlage aus. > **Wichtig:** Die Buchungsregeln gehören in das **Event Template**, nicht in den Prompt des Agenten. Vermeiden Sie im Prompt Anweisungen wie „nur Montag bis Freitag“ oder „nur zwischen 9 und 17 Uhr“—nach dem Verbinden mit Google Calendar kann das mit der integrierten Scheduling-Logik der Plattform kollidieren. ## Google-Calendar-Integration öffnen Nutzen Sie diesen Direktlink zur Google-Calendar-Integrationsseite: **[hier klicken](https://app.callin.io/actions/google-calendar)**.Screenshot: Bereich für Google Calendar, in dem Sie Ihr Konto verbinden, einen Kalender auswählen und Event Templates verwalten.
> **Tipp:** Wenn Ihre Oberfläche leicht anders aussieht, ist das normal—einige Elemente können je nach Konto oder Plan variieren. ## Schritt 1: Google-Konto verbinden 1. Klicken Sie auf der Google-Calendar-Integrationsseite auf **Connect Google Account**. 2. Ein Google-Anmeldefenster öffnet sich. Wählen Sie das Google-Konto aus, das Sie für Buchungen verwenden möchten. 3. Bestätigen Sie die Berechtigungen, damit Callin.io Termine erstellen und Verfügbarkeiten prüfen kann. Nach dem Verbinden sehen Sie typischerweise: * Ihr Google-Konto im linken Bereich * Eine Liste verfügbarer Kalender * Die Option **Disconnect Account** (falls Sie das falsche Konto verbunden haben) > **Wichtig:** Verwenden Sie einen Kalender, der Ihre echte Verfügbarkeit abbildet. Wenn Ihr Google Calendar immer „beschäftigt“ (oder immer „frei“) ist, passt die Buchungserfahrung nicht zur Realität. ## Schritt 2: Den Kalender auswählen, in dem Termine erstellt werden sollen Wählen Sie im linken Bereich den Kalender aus, in den Buchungen geschrieben werden sollen. Beispiele: * Ein Dienstleistungsbetrieb nutzt einen Kalender wie „Appointments“ * Ein Vertriebsteam nutzt „Discovery Calls“ * Eine Praxis nutzt „Consultations“ Warum das wichtig ist: * Ihre Vorlage wird **für einen bestimmten Kalender** erstellt * Später bucht der Agent über den Kalender/die Vorlage, die Sie zuweisen > **Tipp:** Wenn Sie mehrere Kalender haben (z. B. pro Team oder Service), können Sie unterschiedliche Vorlagen pro Kalender erstellen und jedem AI Agent die passende Vorlage zuweisen. ## Schritt 3: Ein Event Template erstellen (hier stehen die Scheduling-Regeln) Bevor Sie die Terminbuchung an einen AI Agent anbinden, müssen Sie mindestens ein **Event Template** erstellen. Diese Vorlage definiert: * Terminlänge * Erinnerungen * Ob überlappende Buchungen erlaubt sind * Konfliktverhalten * Welche Tage buchbar sind (Working Hours) So erstellen Sie eine Vorlage: 1. Klicken Sie im Bereich **Event Templates** auf **Create Event Template**. 2. Füllen Sie die Felder aus (Erklärungen unten). 3. Klicken Sie auf **Save**.Screenshot: Editor für Event Templates, in dem Sie Dauer, Erinnerungen, Konfliktregeln und buchbare Tage festlegen.
### Feld-für-Feld erklärt (mit praxisnahen Beispielen) | Feld | Was es steuert | Beispiel zum Übernehmen | | ----------------------- | --------------------------------------------------------------- | ------------------------------------------ | | **Name** | Bezeichnung des Termin-Typs (damit Sie ihn später wiederfinden) | „Kennenlern-Call (30 Min.)“ | | **Description** | Kurze Beschreibung, wofür der Termin gedacht ist | „Erstgespräch + Bedarf + nächste Schritte“ | | **Slot Duration** | Länge jedes Termins in Minuten | 30 | | **Reminder Minutes** | Wie viele Minuten vorher eine Erinnerung gesendet wird | 15 | | **Reminder Type** | Kanal der Erinnerung (kann variieren) | Email | | **Allow Event Overlap** | Ob mehrere Buchungen zur gleichen Zeit erlaubt sind | No | | **Conflict Handling** | Was bei Überschneidungen passieren soll | Block overlapping events | | **Working Hours** | Welche Tage für Buchungen freigegeben sind | Monday–Friday aktivieren | > **Häufiger Fehler:** **Working Hours** ohne ausgewählte Tage lassen. Die Vorlage ist erst nutzbar, wenn mindestens ein Tag aktiviert ist. ### Beispiel für eine vollständige Vorlage (empfohlener Start) Wenn Sie eine sichere Standardkonfiguration möchten: * **Name:** „Discovery Call (30 min)“ * **Description:** „Erstgespräch, um den Bedarf zu verstehen und nächste Schritte festzulegen“ * **Slot Duration:** 30 * **Reminder Minutes:** 15 * **Reminder Type:** Email * **Allow Event Overlap:** No * **Conflict Handling:** Block overlapping events * **Working Hours:** Monday–Friday Diese Einstellung reduziert Doppelbuchungen und macht die Terminplanung vorhersehbarer. ## Schritt 4: Google-Calendar-Terminbuchung an einen AI Agent anbinden (Call Action) Sobald Sie: * Ein Google-Konto verbunden haben und * Ein Event Template erstellt haben, können Sie die Buchung im AI Agent aktivieren. 1. Gehen Sie im linken Menü zu **AI Agents**. 2. Öffnen Sie den gewünschten Agenten und klicken Sie auf **Edit**. 3. Wechseln Sie zum Tab **Call Action**. 4. Aktivieren Sie **Schedule Appointment**. 5. Wählen Sie **Google Calendar** als Anbieter aus. 6. Klicken Sie auf das **Einstellungs-Symbol** (Zahnrad), um die Konfiguration zu öffnen, und wählen Sie die erstellte Vorlage aus. 7. Klicken Sie auf **Save**.Screenshot: In den Call-Action-Einstellungen des Agenten aktivieren Sie die Terminbuchung und wählen Google Calendar als Anbieter.
> **Wichtig:** Für die beste Genauigkeit sollte die Zeitzone des Agenten zur Zeitzone des Kalenders passen. Eine Abweichung kann zu falschen Zeitvorschlägen führen. ## Wie die Buchung während eines Anrufs ablaufen sollte (empfohlener Ablauf) Wenn alles verbunden ist, funktioniert es am besten, wenn der Agent einem einfachen, menschlichen Ablauf folgt: 1. **Absicht bestätigen**\ Beispiel: „Alles klar—möchten Sie jetzt einen Termin buchen?“ 2. **Minimale Informationen abfragen**\ Fragen Sie nach: * Vollständigem Namen * Telefonnummer\ (Optional: kurzer Anlass des Termins, wenn sinnvoll.) 3. **Verfügbarkeiten anbieten und bestätigen**\ Der Agent sollte buchbare Zeiten vorschlagen (basierend auf Vorlage + Kalenderverfügbarkeit) und die ausgewählte Zeit bestätigen. 4. **Buchen und Details bestätigen**\ Nach der Buchung wiederholt der Agent: * Datum * Uhrzeit * Dauer * Grund/Zweck des Termins ### Beispiel (wie eine „gute“ Buchung klingt) * Anrufer: „Kann ich einen Beratungstermin buchen?“ * Agent: „Ja. Wie ist Ihr vollständiger Name und welche Telefonnummer ist am besten für den Termin?“ * Anrufer: „Jordan Lee, +1 555-010-2040.“ * Agent: „Danke. Lieber früher am Tag oder später? Ich kann eine 30-minütige Beratung buchen.“ * Anrufer: „Später.“ * Agent: „Super—passt Donnerstag um 16:00 Uhr?“ * Anrufer: „Ja.“ * Agent: „Perfekt. Sie sind für Donnerstag um 16:00 Uhr für 30 Minuten gebucht. Sie erhalten außerdem vor dem Termin eine Erinnerung.“ > **Tipp:** Halten Sie den Prompt auf **Datenerfassung und Bestätigung** fokussiert. Lassen Sie die Scheduling-Regeln im Event Template. ## Prompt-Regeln: was hinein gehört (und was nicht) ### Was in den Prompt gehört Der Prompt sollte den Agenten anleiten: * Vor dem Buchen nach Name und Telefonnummer zu fragen * Den Termingrund kurz zu bestätigen (ein Satz) * Die ausgewählte Zeit klar zu bestätigen, bevor final gebucht wird * Am Ende die Buchungsdetails zu bestätigen Beispiel-Anweisung (als normaler Text): * „Wenn jemand buchen möchte, frage zuerst nach vollständigem Namen und Telefonnummer. Schlage dann verfügbare Zeiten vor und bestätige die ausgewählte Zeit. Nach der Buchung wiederhole Datum, Uhrzeit und Dauer zur Bestätigung.“ ### Was NICHT in den Prompt gehört Vermeiden Sie Anweisungen, die das Event Template duplizieren oder überschreiben, z. B.: * „Nur Montag bis Freitag buchen“ * „Nur zwischen 9 und 17 Uhr buchen“ * „Nie am selben Tag buchen“ * „Nur 1 Termin pro Tag erlauben“ Diese Regeln sollten im **Event Template** konfiguriert werden (Working Hours, Konflikte, Überschneidungen). Ein „sauberer“ Prompt verhindert Widersprüche und verbessert die Genauigkeit. > **Wichtig:** Denken Sie so:\ > **Event Template = Regeln und Verfügbarkeit**\ > **Prompt = Gesprächsführung und Datenerfassung** ## Bestes LLM für Scheduling: Gemini 2.5 Flash (empfohlen) Für eine höhere Scheduling-Genauigkeit funktioniert Callin.io am besten mit **Gemini 2.5 Flash**. > **Tipp:** Wenn Buchungen fehlschlagen (falsche Zeiten, Verfügbarkeit wird falsch interpretiert, Verwirrung), stellen Sie das LLM des Agenten auf **Gemini 2.5 Flash** um, speichern Sie und testen Sie erneut. ## Troubleshooting-Checkliste (schnelle Lösungen) ### „Ich habe Google Calendar verbunden, aber ich sehe meinen Kalender nicht“ * Klicken Sie auf der Google-Calendar-Seite auf **Sync**. * Prüfen Sie, ob Sie das richtige Google-Konto verbunden haben. ### „Es wird keine Verfügbarkeit gefunden“ * Prüfen Sie **Working Hours** im Event Template (mindestens ein Tag muss aktiviert sein). * Stellen Sie sicher, dass Ihr Google Calendar nicht vollständig durch „busy“-Termine blockiert ist. ### „Der Agent bucht zur falschen Uhrzeit“ * Prüfen Sie, ob die Zeitzone des Agenten zur Zeitzone des Kalenders passt. * Wenn das Verhalten inkonsistent ist, wechseln Sie zu **Gemini 2.5 Flash**. ### „Es kommt zu Doppelbuchungen“ * Setzen Sie **Allow Event Overlap** auf **No**. * Wählen Sie eine Konfliktoption, die überschneidende Termine blockiert. # Google Calendar Source: https://support.callin.io/Create-AI-Agent/Google-Calendar-copied-2 Guía paso a paso para conectar Google Calendar en Callin.io, crear una plantilla de evento (disponibilidad + duración + recordatorios) y asignarla a un AI Agent para que reserve citas durante las llamadas, sin meter reglas de horario en el prompt que puedan interferir. ## Qué vas a configurar (y por qué es importante) La reserva con Google Calendar en Callin.io está pensada para ser consistente y confiable. Para lograrlo, la configuración se divide en dos partes: 1. **Configuración de la integración de Google Calendar**\ Conectas tu cuenta de Google y creas una **Plantilla de Evento**. Esa plantilla es donde se definen las reglas de reserva (días disponibles, duración, recordatorios y manejo de conflictos). 2. **Configuración del AI Agent (Call Action)**\ Activas **Schedule Appointment** dentro del agente y seleccionas la plantilla que creaste. > **Importante:** Las reglas de reserva deben vivir en la **Plantilla de Evento**, no en el prompt del agente. Evita instrucciones como “Solo de lunes a viernes” o “Solo entre 9am y 5pm” dentro del prompt—esas reglas pueden interferir con la lógica de agenda que ya trae la plataforma al conectar Google Calendar. ## Abrir la integración de Google Calendar Usa este enlace directo para abrir la integración de Google Calendar: **[haz clic aquí](https://app.callin.io/actions/google-calendar)**.Captura: Esta es el área de Google Calendar donde conectas tu cuenta, eliges un calendario y administras plantillas de eventos.
> **Consejo:** Si tu interfaz se ve un poco diferente, es normal—algunos elementos pueden variar según tu cuenta o plan. ## Paso 1: Conectar tu cuenta de Google 1. En la página de integración de Google Calendar, haz clic en **Connect Google Account**. 2. Se abre una ventana de inicio de sesión de Google. Elige la cuenta que quieres usar para reservas. 3. Acepta la pantalla de permisos para que Callin.io pueda crear eventos y comprobar disponibilidad. Cuando se conecta correctamente, normalmente verás: * Tu cuenta de Google en el panel izquierdo * Un listado de calendarios para seleccionar * La opción **Disconnect Account** (úsala si conectaste la cuenta equivocada) > **Importante:** Usa un calendario que refleje tu disponibilidad real. Si tu Google Calendar está siempre “ocupado” (o siempre “libre”), la experiencia de reserva no va a coincidir con la realidad. ## Paso 2: Elegir el calendario donde se crearán las citas En el panel izquierdo, selecciona el calendario donde quieres que se creen las reservas. Ejemplos: * Un negocio de servicios puede usar un calendario llamado “Citas” * Un equipo de ventas puede usar “Discovery Calls” * Una clínica puede usar “Consultas” Por qué esta selección importa: * Tu plantilla se crea **para un calendario específico** * Luego el agente reservará usando el calendario/plantilla que le asignes > **Consejo:** Si tienes varios calendarios (por equipo o por servicio), puedes crear plantillas distintas por calendario y asignar la correcta a cada AI Agent. ## Paso 3: Crear una Plantilla de Evento (aquí van las reglas de agenda) Antes de conectar la agenda a un AI Agent, necesitas crear al menos una **Plantilla de Evento**. Esta plantilla define: * Cuánto dura cada cita * Cómo funcionan los recordatorios * Si se permite solapar reservas * Cómo se manejan conflictos * Qué días están disponibles (Working Hours) Para crearla: 1. En la sección **Event Templates**, haz clic en **Create Event Template**. 2. Completa los campos (explicación abajo). 3. Haz clic en **Save**.Captura: El editor de Plantilla de Evento donde defines duración, recordatorios, reglas de conflicto y días de trabajo.
### Explicación campo por campo (con ejemplos prácticos) | Campo | Qué controla | Ejemplo listo para copiar | | ----------------------- | ------------------------------------------------------ | ------------------------------------------- | | **Name** | La etiqueta del tipo de cita (para reconocerla luego) | “Llamada Intro (30 min)” | | **Description** | Ayuda al equipo a entender para qué es la cita | “Introducción + calificar + próximos pasos” | | **Slot Duration** | Duración de cada cita en minutos | 30 | | **Reminder Minutes** | Cuántos minutos antes se envía el recordatorio | 15 | | **Reminder Type** | Canal del recordatorio (puede variar) | Email | | **Allow Event Overlap** | Si se permite reservar más de una cita al mismo tiempo | No | | **Conflict Handling** | Qué pasa cuando hay solapamientos | Bloquear eventos solapados | | **Working Hours** | Qué días se pueden reservar | Habilitar lunes–viernes | > **Error común:** Dejar **Working Hours** sin días seleccionados. La plantilla no será usable hasta habilitar al menos un día. ### Ejemplo de plantilla completa (recomendación inicial) Si quieres un punto de partida seguro: * **Name:** “Discovery Call (30 min)” * **Description:** “Primera llamada para entender necesidad y definir próximos pasos” * **Slot Duration:** 30 * **Reminder Minutes:** 15 * **Reminder Type:** Email * **Allow Event Overlap:** No * **Conflict Handling:** Bloquear eventos solapados * **Working Hours:** Lunes–viernes Esta configuración evita dobles reservas y hace que la agenda sea predecible. ## Paso 4: Conectar la reserva de Google Calendar a un AI Agent (Call Action) Una vez que: * Conectaste una cuenta de Google, y * Creaste una Plantilla de Evento, Ahora sí puedes habilitar reservas dentro de un AI Agent. 1. Ve a **AI Agents** en el menú izquierdo. 2. Abre el agente que quieres configurar y haz clic en **Edit**. 3. Entra a la pestaña **Call Action**. 4. Activa **Schedule Appointment**. 5. Selecciona **Google Calendar** como proveedor. 6. Haz clic en el **icono de configuración** (engranaje) para abrir la configuración y seleccionar la plantilla que creaste. 7. Haz clic en **Save**.Captura: Dentro de Call Action del agente, habilita reservas y elige Google Calendar como proveedor de agenda.
> **Importante:** Para mejores resultados, asegúrate de que la zona horaria del agente coincida con la zona horaria del calendario. Si no coincide, el agente puede sugerir horarios “corridos”. ## Cómo debería funcionar la reserva durante la llamada (flujo recomendado) Con todo conectado, la mejor experiencia se logra cuando el agente sigue un flujo sencillo y humano: 1. **Confirmar intención**\ “Perfecto—¿quieres que te agende una cita ahora?” 2. **Pedir los datos mínimos necesarios**\ Pide: * Nombre completo * Número de teléfono\ (Opcional: motivo breve de la cita, si aplica.) 3. **Proponer disponibilidad y confirmar**\ El agente debe proponer horarios que pueda reservar (según tu plantilla + disponibilidad del calendario) y confirmar el horario elegido. 4. **Reservar y confirmar detalles**\ Tras reservar, repetir: * Fecha * Hora * Duración * Motivo de la cita ### Ejemplo (cómo suena una “buena” reserva) * Persona: “¿Puedo agendar una consulta?” * Agente: “Sí. ¿Me dices tu nombre completo y el mejor número de teléfono para la cita?” * Persona: “Jordan Lee, +1 555-010-2040.” * Agente: “Gracias. ¿Prefieres más temprano o más tarde? Puedo agendar una consulta de 30 minutos.” * Persona: “Más tarde.” * Agente: “Perfecto—¿te va bien el jueves a las 4:00 PM?” * Persona: “Sí.” * Agente: “Listo. Quedas agendado para el jueves a las 4:00 PM por 30 minutos. También recibirás un recordatorio antes de la cita.” > **Consejo:** Mantén el prompt enfocado en **pedir datos y confirmar**. Deja que la plantilla maneje las reglas de horario. ## Reglas del prompt: qué incluir (y qué evitar) ### Qué sí debes incluir en el prompt Tu prompt debe indicar que el agente: * Pida nombre y teléfono antes de reservar * Confirme el motivo de la cita de forma breve (una frase) * Confirme claramente el horario antes de finalizar * Confirme los detalles de la reserva al final Una instrucción práctica (en texto normal) puede ser: * “Cuando la persona quiera agendar, primero pide su nombre completo y su teléfono. Luego sugiere horarios disponibles y confirma el elegido. Después de reservar, repite fecha, hora y duración para confirmar.” ### Qué NO debes incluir en el prompt Evita instrucciones que dupliquen o intenten reemplazar la Plantilla de Evento, como: * “Solo de lunes a viernes” * “Solo entre 9am y 5pm” * “Nunca reservar el mismo día” * “Solo permitir 1 cita por día” Esas reglas deben configurarse en la **Plantilla de Evento** (Working Hours, conflicto, solapamiento). Mantener el prompt “limpio” evita interferencias y mejora la precisión. > **Importante:** Piénsalo así:\ > **Plantilla = reglas y disponibilidad**\ > **Prompt = conversación y captura de datos** ## Mejor LLM para reservas: Gemini 2.5 Flash (recomendado) Para precisión de agenda, Callin.io funciona mejor con **Gemini 2.5 Flash**. > **Consejo:** Si la reserva falla (horarios incorrectos, disponibilidad mal interpretada, confusión), cambia el LLM del agente a **Gemini 2.5 Flash**, guarda y vuelve a probar. ## Checklist de troubleshooting (arreglos rápidos) ### “Conecté Google Calendar pero no veo mi calendario” * Haz clic en **Sync** en la página de Google Calendar. * Confirma que conectaste la cuenta correcta. ### “No encuentra disponibilidad” * Revisa **Working Hours** en tu plantilla (debe haber al menos un día habilitado). * Asegúrate de que tu Google Calendar no esté completamente bloqueado con eventos ocupados. ### “El agente agenda en una hora equivocada” * Verifica que la zona horaria del agente coincide con la del calendario. * Si el comportamiento es inconsistente, cambia a **Gemini 2.5 Flash**. ### “Se están creando dobles reservas” * Configura **Allow Event Overlap** en **No**. * Usa una opción de conflicto que bloquee eventos solapados. # Google calendar Source: https://support.callin.io/Create-AI-Agent/Google-Calendar-copied-3 Guida passo passo per collegare Google Calendar in Callin.io, creare un modello evento (disponibilità + durata + promemoria) e assegnarlo a un AI Agent per prenotare appuntamenti durante le chiamate—senza aggiungere nel prompt regole di orario in conflitto. ## Cosa configurerai (e perché è importante) La prenotazione con Google Calendar in Callin.io è progettata per essere coerente e affidabile. Per questo la configurazione è divisa in due parti: 1. **Configurazione dell’integrazione Google Calendar**\ Colleghi il tuo account Google e crei un **Event Template**. È qui che imposti le regole di prenotazione (giorni disponibili, durata, promemoria e gestione dei conflitti). 2. **Configurazione dell’AI Agent (Call Action)**\ Attivi **Schedule Appointment** nell’agente e selezioni il modello creato. > **Importante:** Le regole di prenotazione devono stare nell’**Event Template**, non nel prompt dell’agente. Evita istruzioni come “solo dal lunedì al venerdì” o “solo tra le 9 e le 17” nel prompt: una volta collegato Google Calendar possono entrare in conflitto con la logica di scheduling già integrata nella piattaforma. ## Apri l’integrazione Google Calendar Usa questo link diretto per aprire la pagina di integrazione Google Calendar: **[clicca qui](https://app.callin.io/actions/google-calendar)**.Screenshot: Area Google Calendar dove colleghi l’account, scegli un calendario e gestisci i modelli di evento.
> **Suggerimento:** Se la tua interfaccia è leggermente diversa, è normale: alcuni elementi possono variare in base all’account o al piano. ## Step 1: Collega il tuo account Google 1. Nella pagina di integrazione Google Calendar, clicca su **Connect Google Account**. 2. Si apre una finestra di accesso Google. Seleziona l’account che vuoi usare per le prenotazioni. 3. Approva la schermata dei permessi, così Callin.io può creare eventi e verificare la disponibilità. Dopo il collegamento, di solito vedrai: * Il tuo account Google nel pannello a sinistra * L’elenco dei calendari disponibili * L’opzione **Disconnect Account** (utile se hai collegato l’account sbagliato) > **Importante:** Usa un calendario che rispecchi la tua disponibilità reale. Se il tuo Google Calendar risulta sempre “occupato” (o sempre “libero”), l’esperienza di prenotazione non sarà realistica. ## Step 2: Scegli il calendario in cui verranno creati gli appuntamenti Nel pannello a sinistra, seleziona il calendario in cui vuoi che vengano inserite le prenotazioni. Esempi: * Un’attività di servizi può usare un calendario chiamato “Appointments” * Un team commerciale può usare “Discovery Calls” * Uno studio può usare “Consultations” Perché questa scelta è importante: * Il modello viene creato **per un calendario specifico** * In seguito l’agente prenoterà usando il calendario/modello che gli assegni > **Suggerimento:** Se hai più calendari (per team o per servizio), puoi creare modelli diversi per ciascun calendario e assegnare quello corretto a ogni AI Agent. ## Step 3: Crea un Event Template (qui vivono le regole di scheduling) Prima di collegare lo scheduling a un AI Agent, devi creare almeno un **Event Template**. Questo modello definisce: * Durata degli appuntamenti * Funzionamento dei promemoria * Se sono consentite prenotazioni sovrapposte * Gestione dei conflitti * Giorni disponibili (Working Hours) Per crearlo: 1. Nella sezione **Event Templates**, clicca su **Create Event Template**. 2. Compila i campi (spiegati sotto). 3. Clicca su **Save**.Screenshot: Editor del modello evento dove definisci durata, promemoria, regole di conflitto e giorni disponibili.
### Spiegazione campo per campo (con esempi pratici) | Campo | Cosa controlla | Esempio pronto da copiare | | ----------------------- | ---------------------------------------------------------- | -------------------------------------- | | **Name** | Etichetta del tipo di appuntamento (per riconoscerlo dopo) | “Chiamata introduttiva (30 min)” | | **Description** | Nota per chiarire lo scopo dell’appuntamento | “Prima call + bisogni + prossimi step” | | **Slot Duration** | Durata di ogni appuntamento (in minuti) | 30 | | **Reminder Minutes** | Quanti minuti prima inviare il promemoria | 15 | | **Reminder Type** | Canale del promemoria (può variare) | Email | | **Allow Event Overlap** | Se consentire più prenotazioni nello stesso orario | No | | **Conflict Handling** | Cosa fare in caso di sovrapposizioni | Block overlapping events | | **Working Hours** | Giorni abilitati alla prenotazione | Abilitare Monday–Friday | > **Errore comune:** Lasciare **Working Hours** senza selezionare alcun giorno. Il modello non sarà utilizzabile finché non abiliti almeno un giorno. ### Un esempio di modello completo (consigliato per iniziare) Se vuoi un’impostazione “sicura” di partenza: * **Name:** “Discovery Call (30 min)” * **Description:** “Prima chiamata per capire il bisogno e definire i prossimi step” * **Slot Duration:** 30 * **Reminder Minutes:** 15 * **Reminder Type:** Email * **Allow Event Overlap:** No * **Conflict Handling:** Block overlapping events * **Working Hours:** Monday–Friday Questa configurazione riduce le doppie prenotazioni e rende lo scheduling più prevedibile. ## Step 4: Collega lo scheduling Google Calendar a un AI Agent (Call Action) Dopo aver: * Collegato un account Google, e * Creato un Event Template, puoi attivare la prenotazione in un AI Agent. 1. Vai su **AI Agents** nel menu a sinistra. 2. Apri l’agente da configurare e clicca **Edit**. 3. Vai alla scheda **Call Action**. 4. Attiva **Schedule Appointment**. 5. Seleziona **Google Calendar** come provider. 6. Clicca l’**icona impostazioni** (ingranaggio) per aprire la configurazione e selezionare il modello che hai creato. 7. Clicca **Save**.Screenshot: Nelle impostazioni Call Action dell’agente, abilita lo scheduling e scegli Google Calendar come provider.
> **Importante:** Per risultati migliori, assicurati che il fuso orario dell’agente corrisponda al fuso orario del calendario. Un disallineamento può causare suggerimenti di orari “sballati”. ## Come dovrebbe avvenire la prenotazione durante la chiamata (flusso consigliato) Con tutto collegato, l’esperienza migliore si ottiene quando l’agente segue un flusso semplice e naturale: 1. **Conferma l’intenzione**\ Esempio: “Perfetto—vuoi che ti prenoti un appuntamento adesso?” 2. **Raccogli le informazioni minime necessarie**\ Chiedi: * Nome e cognome * Numero di telefono\ (Opzionale: un motivo breve dell’appuntamento, se utile.) 3. **Proponi disponibilità e conferma**\ L’agente deve proporre orari prenotabili (in base al modello + disponibilità del calendario) e confermare l’orario scelto. 4. **Prenota e conferma i dettagli**\ Dopo la prenotazione, l’agente ripete: * Data * Ora * Durata * Motivo dell’appuntamento ### Esempio (come suona una “buona” prenotazione) * Cliente: “Posso prenotare una consulenza?” * Agente: “Sì. Mi dici nome e cognome e il miglior numero di telefono per l’appuntamento?” * Cliente: “Jordan Lee, +1 555-010-2040.” * Agente: “Grazie. Preferisci più presto o più tardi nella giornata? Posso prenotare una consulenza di 30 minuti.” * Cliente: “Più tardi.” * Agente: “Perfetto—va bene giovedì alle 16:00?” * Cliente: “Sì.” * Agente: “Ottimo. Sei prenotato per giovedì alle 16:00 per 30 minuti. Riceverai anche un promemoria prima dell’appuntamento.” > **Suggerimento:** Mantieni il prompt focalizzato su **raccolta dati e conferma**. Lascia che l’Event Template gestisca le regole di scheduling. ## Regole per il prompt: cosa includere (e cosa evitare) ### Cosa includere nel prompt Il prompt dovrebbe guidare l’agente a: * Chiedere nome e telefono prima di prenotare * Confermare il motivo dell’appuntamento in modo breve (una frase) * Confermare chiaramente l’orario scelto prima di finalizzare * Confermare i dettagli della prenotazione alla fine Esempio di istruzione (in testo semplice): * “Se la persona vuole prenotare, chiedi prima nome e cognome e numero di telefono. Poi proponi orari disponibili e conferma quello scelto. Dopo la prenotazione, ripeti data, ora e durata per confermare.” ### Cosa NON includere nel prompt Evita istruzioni che duplicano o sovrascrivono l’Event Template, ad esempio: * “Prenota solo dal lunedì al venerdì” * “Prenota solo tra le 9 e le 17” * “Non prenotare mai lo stesso giorno” * “Consenti solo 1 appuntamento al giorno” Queste regole vanno configurate nell’**Event Template** (Working Hours, conflitti, sovrapposizioni). Tenere il prompt “pulito” evita contraddizioni e migliora la precisione. > **Importante:** Pensala così:\ > **Event Template = regole e disponibilità**\ > **Prompt = conversazione e raccolta informazioni** ## Miglior LLM per lo scheduling: Gemini 2.5 Flash (consigliato) Per una maggiore precisione nello scheduling, Callin.io funziona meglio con **Gemini 2.5 Flash**. > **Suggerimento:** Se la prenotazione fallisce (orari errati, disponibilità interpretata male, confusione), passa il LLM dell’agente a **Gemini 2.5 Flash**, salva e riprova. ## Checklist di troubleshooting (fix rapidi) ### “Ho collegato Google Calendar ma non vedo il mio calendario” * Clicca **Sync** nella pagina Google Calendar. * Controlla di aver collegato l’account Google corretto. ### “Non trova disponibilità” * Verifica **Working Hours** nel modello (deve esserci almeno un giorno abilitato). * Assicurati che il tuo Google Calendar non sia completamente pieno di eventi “busy”. ### “L’agente prenota all’ora sbagliata” * Verifica che il fuso orario dell’agente coincida con quello del calendario. * Se il comportamento è incoerente, passa a **Gemini 2.5 Flash**. ### “Si creano doppie prenotazioni” * Imposta **Allow Event Overlap** su **No**. * Seleziona una gestione conflitti che blocchi gli eventi sovrapposti. # Google Calendar Source: https://support.callin.io/Create-AI-Agent/Google-Calendar-copied-4 Guide pas à pas pour connecter Google Calendar dans Callin.io, créer un modèle d’événement (disponibilité + durée + rappels) et l’attribuer à un AI Agent afin qu’il puisse réserver des rendez-vous pendant les appels—sans ajouter de règles d’horaires conflictuelles dans le prompt. ## Ce que vous allez configurer (et pourquoi c’est important) La prise de rendez-vous avec Google Calendar dans Callin.io est pensée pour être cohérente et fiable. Pour y parvenir, la configuration est séparée en deux parties : 1. **Configuration de l’intégration Google Calendar**\ Vous connectez votre compte Google et créez un **Event Template**. C’est dans ce modèle que vous définissez les règles de réservation (jours disponibles, durée, rappels et gestion des conflits). 2. **Configuration de l’AI Agent (Call Action)**\ Vous activez **Schedule Appointment** dans votre agent et vous sélectionnez le modèle créé. > **Important :** Les règles de réservation doivent être définies dans l’**Event Template**, pas dans le prompt de l’agent. Évitez d’ajouter des instructions du type « uniquement du lundi au vendredi » ou « seulement entre 9 h et 17 h » dans le prompt : une fois Google Calendar connecté, cela peut entrer en conflit avec la logique de planification intégrée de la plateforme. ## Ouvrir l’intégration Google Calendar Utilisez ce lien direct pour ouvrir la page d’intégration Google Calendar : [**cliquez ici**](https://app.callin.io/actions/google-calendar).Capture : Zone Google Calendar où vous connectez votre compte, choisissez un calendrier et gérez les modèles d’événements.
> **Conseil :** Si votre interface est légèrement différente, c’est normal : certains éléments peuvent varier selon votre compte ou votre plan. ## Étape 1 : Connecter votre compte Google 1. Sur la page d’intégration Google Calendar, cliquez sur **Connect Google Account**. 2. Une fenêtre de connexion Google s’ouvre. Choisissez le compte Google que vous souhaitez utiliser pour les réservations. 3. Acceptez l’écran d’autorisations afin que Callin.io puisse créer des événements et vérifier les disponibilités. Une fois connecté, vous verrez généralement : * Votre compte Google affiché dans le panneau de gauche * La liste des calendriers disponibles * L’option **Disconnect Account** (utile si vous avez connecté le mauvais compte) > **Important :** Utilisez un calendrier qui reflète votre disponibilité réelle. Si votre Google Calendar est toujours « occupé » (ou toujours « libre »), l’expérience de réservation ne correspondra pas à la réalité. ## Étape 2 : Choisir le calendrier dans lequel les rendez-vous seront créés Dans le panneau de gauche, sélectionnez le calendrier dans lequel vous souhaitez que les réservations soient ajoutées. Exemples : * Une entreprise de services peut utiliser un calendrier nommé « Appointments » * Une équipe commerciale peut utiliser « Discovery Calls » * Un cabinet peut utiliser « Consultations » Pourquoi ce choix est important : * Votre modèle est créé **pour un calendrier précis** * Ensuite, l’agent réservera en utilisant le calendrier/le modèle que vous lui attribuerez > **Conseil :** Si vous avez plusieurs calendriers (par équipe ou par service), vous pouvez créer différents modèles par calendrier et attribuer le bon modèle à chaque AI Agent. ## Étape 3 : Créer un Event Template (c’est ici que vivent les règles de planification) Avant de rattacher la planification à un AI Agent, vous devez créer au moins un **Event Template**. Ce modèle définit : * La durée des rendez-vous * Le fonctionnement des rappels * Si les réservations qui se chevauchent sont autorisées * La gestion des conflits * Les jours ouverts à la réservation (Working Hours) Pour le créer : 1. Dans la section **Event Templates**, cliquez sur **Create Event Template**. 2. Renseignez les champs (explications ci-dessous). 3. Cliquez sur **Save**.Capture : Éditeur du modèle d’événement où vous définissez la durée, les rappels, les règles de conflit et les jours de disponibilité.
### Explication champ par champ (avec exemples concrets) | Champ | À quoi ça sert | Exemple prêt à copier | | ----------------------- | ------------------------------------------------------------- | ------------------------------------------------- | | **Name** | Le nom du type de rendez-vous (pour le retrouver facilement) | « Appel découverte (30 min) » | | **Description** | Un mémo pour préciser l’objectif du rendez-vous | « Premier échange + besoins + prochaines étapes » | | **Slot Duration** | Durée de chaque rendez-vous (en minutes) | 30 | | **Reminder Minutes** | Nombre de minutes avant le rendez-vous pour envoyer le rappel | 15 | | **Reminder Type** | Canal du rappel (peut varier) | Email | | **Allow Event Overlap** | Autoriser ou non plusieurs réservations au même créneau | No | | **Conflict Handling** | Comment gérer les chevauchements | Block overlapping events | | **Working Hours** | Jours autorisés pour la réservation | Activer Monday–Friday | > **Erreur fréquente :** Laisser **Working Hours** sans jour sélectionné. Le modèle ne sera pas utilisable tant qu’au moins un jour n’est pas activé. ### Exemple de modèle complet (recommandation de départ) Si vous voulez un réglage par défaut « sûr » : * **Name :** « Discovery Call (30 min) » * **Description :** « Premier appel pour comprendre le besoin et définir les prochaines étapes » * **Slot Duration :** 30 * **Reminder Minutes :** 15 * **Reminder Type :** Email * **Allow Event Overlap :** No * **Conflict Handling :** Block overlapping events * **Working Hours :** Monday–Friday Cette configuration évite les doubles réservations et rend la planification plus prévisible. ## Étape 4 : Rattacher la planification Google Calendar à un AI Agent (Call Action) Une fois que vous avez : * Connecté un compte Google, et * Créé un Event Template, vous pouvez activer la réservation dans un AI Agent. 1. Allez dans **AI Agents** dans le menu de gauche. 2. Ouvrez l’agent à configurer et cliquez sur **Edit**. 3. Ouvrez l’onglet **Call Action**. 4. Activez **Schedule Appointment**. 5. Sélectionnez **Google Calendar** comme fournisseur. 6. Cliquez sur l’**icône de réglages** (roue dentée) pour ouvrir la configuration et sélectionner le modèle que vous avez créé. 7. Cliquez sur **Save**.Capture : Dans Call Action de l’agent, activez la planification et choisissez Google Calendar comme fournisseur.
> **Important :** Pour de meilleurs résultats, assurez-vous que le fuseau horaire de l’agent correspond à celui de votre calendrier. Un décalage peut entraîner des suggestions d’horaires incorrectes. ## Comment la réservation doit se dérouler pendant un appel (flux recommandé) Une fois la configuration terminée, l’expérience est optimale quand l’agent suit un flux simple et naturel : 1. **Confirmer l’intention**\ Exemple : « Très bien — souhaitez-vous réserver un rendez-vous maintenant ? » 2. **Collecter le minimum d’informations nécessaires**\ Demandez : * Nom complet * Numéro de téléphone\ (Optionnel : une courte raison du rendez-vous, si utile.) 3. **Proposer des disponibilités et confirmer**\ L’agent doit proposer des créneaux qu’il peut réserver (selon votre modèle + la disponibilité du calendrier), puis confirmer le créneau choisi. 4. **Réserver et confirmer les détails**\ Après la réservation, l’agent répète : * La date * L’heure * La durée * Le motif du rendez-vous ### Exemple (à quoi ressemble une “bonne” réservation) * Appelant : « Je peux prendre un rendez-vous pour une consultation ? » * Agent : « Oui. Quel est votre nom complet et le meilleur numéro de téléphone pour le rendez-vous ? » * Appelant : « Jordan Lee, +1 555-010-2040. » * Agent : « Merci. Préférez-vous plutôt en début de journée ou plus tard ? Je peux réserver une consultation de 30 minutes. » * Appelant : « Plus tard. » * Agent : « Parfait — est-ce que jeudi à 16h00 vous convient ? » * Appelant : « Oui. » * Agent : « Super. C’est réservé pour jeudi à 16h00 pour 30 minutes. Vous recevrez aussi un rappel avant le rendez-vous. » > **Conseil :** Gardez le prompt centré sur **la collecte d’informations et la confirmation**. Laissez l’Event Template gérer les règles de planification. ## Règles du prompt : quoi inclure (et quoi éviter) ### Ce que vous devez inclure dans le prompt Votre prompt doit guider l’agent à : * Demander le nom et le téléphone avant de réserver * Confirmer le motif du rendez-vous brièvement (une phrase) * Confirmer clairement l’heure choisie avant de finaliser * Confirmer les détails de la réservation à la fin Exemple d’instruction (en texte simple) : * « Si la personne veut réserver, demande d’abord son nom complet et son numéro de téléphone. Propose ensuite des créneaux disponibles et confirme celui qui est choisi. Après la réservation, répète la date, l’heure et la durée pour confirmer. » ### Ce que vous ne devez PAS inclure dans le prompt Évitez les instructions qui dupliquent ou remplacent l’Event Template, par exemple : * « Réserver uniquement du lundi au vendredi » * « Réserver uniquement entre 9 h et 17 h » * « Ne jamais réserver le jour même » * « Autoriser seulement un rendez-vous par jour » Ces règles doivent être définies dans l’**Event Template** (Working Hours, conflits, chevauchement). Garder le prompt “propre” évite les contradictions et améliore la précision. > **Important :** Pensez comme ceci :\ > **Event Template = règles et disponibilité**\ > **Prompt = conversation et collecte d’informations** ## Meilleur LLM pour la planification : Gemini 2.5 Flash (recommandé) Pour une meilleure précision de planification, Callin.io fonctionne mieux avec **Gemini 2.5 Flash**. > **Conseil :** Si la réservation échoue (mauvais horaires, disponibilité mal interprétée, confusion), basculez le LLM de l’agent sur **Gemini 2.5 Flash**, enregistrez, puis testez à nouveau. ## Liste de dépannage (solutions rapides) ### « J’ai connecté Google Calendar mais je ne vois pas mon calendrier » * Cliquez sur **Sync** sur la page Google Calendar. * Vérifiez que vous avez connecté le bon compte Google. ### « Il n’y a aucune disponibilité » * Vérifiez **Working Hours** dans votre Event Template (au moins un jour doit être activé). * Assurez-vous que votre Google Calendar n’est pas entièrement bloqué par des événements “occupés”. ### « L’agent réserve à la mauvaise heure » * Vérifiez que le fuseau horaire de l’agent correspond à celui du calendrier. * Si le comportement est incohérent, passez à **Gemini 2.5 Flash**. ### « Il y a des doubles réservations » * Réglez **Allow Event Overlap** sur **No**. * Choisissez une option de conflit qui bloque les événements qui se chevauchent. # Knowledge Base Source: https://support.callin.io/Create-AI-Agent/Knowledbase Create a shared library of Files and Web URLs that your AI agents can reference to answer questions more accurately. ## What the Knowledge Base is for The **Knowledge Base** is where you store information that your AI agents can use during conversations—so they don’t have to rely only on the main prompt. Typical use cases: * Answering questions about your business (services, pricing, policies, hours). * Guiding users through processes (refund steps, appointment prep, onboarding). * Keeping responses consistent across multiple agents. Access it here: [Knowledge Base](https://app.callin.io/knowledge-base) > **Tip:** Think of the Knowledge Base as “approved reference material” your agent can pull from when a caller asks detailed questions. ## How it connects to AI agents You don’t add the content directly inside an agent. Instead, you: 1. Build your Knowledge Base content here (Files or Web URLs). 2. Then, when editing an agent, you **select the Knowledge Base group** you want that agent to use. > **Important:** If you update a Knowledge Base group and want the changes to affect an existing agent, you may need to go back to the agent editor and click an **Update** action in the Knowledge Base section (this can vary depending on your account/plan). ## Files Knowledge Base The **Files** tab is for uploading documents your agent should learn from (for example: a PDF policy, a DOCX script, or a TXT FAQ). Files are organized into **groups**, so you can attach the right set of documents to the right agent.Screenshot: The Knowledge Base in Files mode, where you upload documents and organize them into groups.
### Create a file group and upload documents 1. Open the **Files** tab. 2. Click **Create Knowledge base**. 3. In the upload modal, enter a **Group Name** (required). 4. Add your documents: * Drag and drop files into the upload area, or * Click **Select Files** to browse. 5. Click **Upload Files** to finish. Supported formats and limits (as shown in the uploader): * PDF, DOC, DOCX, TXT * Max 5MB per file > **Common mistake:** Uploading multiple unrelated documents into one group. If you have different use cases (Sales vs. Support), create separate groups so you can attach the right knowledge to each agent. ### Manage and update files in a group After a group exists, you can open it to manage what’s inside: * Add more documents (for example, using **Add New Files**). * See a list of **Current Files** already included. * Remove files you no longer want the agent to reference. > **Tip:** Use clear group names like **“Support Policies”**, **“Pricing & Plans”**, or **“Clinic Intake Script”** so it’s easy to select the correct group later. ## Web URLs Knowledge Base The **Web** tab is for teaching your agent from web pages. You create a **URL group**, give it a title, and add one or more URLs. This is useful when your source of truth lives on your website (help center, docs, policy pages, landing pages).Screenshot: The Knowledge Base in Web mode, where you add and manage groups of website URLs.
### Create a URL group 1. Open the **Web** tab. 2. Click **Add Web URL**. 3. Fill in: * **Title** (required): the name of the URL group (this title is used for all URLs in the group). * **URL #1**: paste the first webpage link. 4. (Optional) Click **Add Another URL** to include more pages. 5. Click **Add URL** to save the group. > **Tip:** Keep URL groups focused. For example, make one group for **“Pricing & Billing”** URLs and a different group for **“Refund Policy”** URLs. ### Edit or delete a URL group Once a URL group is created, you can manage it from the list: * **Edit** the group title and URLs. * **Delete** the group if you no longer need it. * Open the group to see what’s included. Inside the edit modal, you can: * Update the **Title** * Add or remove individual URLs * Click **Save** to apply changes > **Important:** If you change URLs and need an existing agent to use the updated content, you may need to re-open the agent editor and apply an **Update** in the Knowledge Base section (this can vary depending on your account/plan). ## Select a Knowledge Base for an agent After you’ve created your groups (Files or Web URLs), you attach one to an agent during agent editing.Screenshot: Selecting a Knowledge Base group while editing an AI agent (choose Files or Web URLs, then select a group).
### Attach a group to an agent 1. Go to **AI Agents** and open an agent to edit. 2. Find the **Knowledge Base** section. 3. Click **Add**. 4. Choose the **Source**: * **Files**, or * **Web URLs** 5. Select a **Group** (for example: “Support Policies” or “Company Website Docs”). 6. Click **Select** to attach it to the agent. You may also see a **Refresh** option to reload the list of groups. > **Tip:** If you have multiple agents with different roles, give each agent a different Knowledge Base group so they stay focused and don’t answer outside their scope. ## Practical example Let’s say you run a dental clinic and you have two agents: * **Front Desk Agent** (appointments, opening hours, directions) * **Billing Agent** (pricing, invoices, insurance questions) A good setup could be: * Files group: **“Clinic FAQs (TXT)”** for quick answers and scripts * Web URLs group: **“Pricing & Insurance Pages”** pointing to your public website pages Then: * The **Front Desk Agent** gets the FAQs group. * The **Billing Agent** gets the Pricing & Insurance URLs group. # Base de conocimiento Source: https://support.callin.io/Create-AI-Agent/Knowledbase-copied-1 Crea una biblioteca compartida de archivos y URLs web que tus agentes de IA pueden consultar para responder con más precisión. ## Para qué sirve la Base de conocimiento La **Base de conocimiento** es el lugar donde guardas información que tus agentes de IA pueden usar durante las conversaciones, para que no dependan solo del prompt principal. Casos típicos de uso: * Responder preguntas sobre tu negocio (servicios, precios, políticas, horarios). * Guiar a los usuarios en procesos (pasos de reembolso, preparación de citas, onboarding). * Mantener respuestas consistentes entre varios agentes. Accede aquí: [Base de conocimiento](https://app.callin.io/knowledge-base) > **Consejo:** Piensa en la Base de conocimiento como “material de referencia aprobado” que el agente puede consultar cuando una persona hace preguntas detalladas. ## Cómo se conecta con los agentes de IA No añades el contenido directamente dentro de un agente. En su lugar: 1. Construyes el contenido de la Base de conocimiento aquí (Files o Web URLs). 2. Luego, al editar un agente, **seleccionas el grupo** de Base de conocimiento que quieres que use ese agente. > **Importante:** Si actualizas un grupo de Base de conocimiento y quieres que los cambios se reflejen en un agente existente, puede que tengas que volver al editor del agente y hacer clic en una acción de **Update** dentro de la sección de Base de conocimiento (esto puede variar según tu cuenta/plan). ## Base de conocimiento con Files La pestaña **Files** sirve para subir documentos de los que el agente debe aprender (por ejemplo: una política en PDF, un guion en DOCX o un FAQ en TXT). Los archivos se organizan en **grupos**, para que puedas asignar el conjunto correcto de documentos al agente correcto.Captura: La Base de conocimiento en modo Files, donde subes documentos y los organizas en grupos.
### Crear un grupo de archivos y subir documentos 1. Abre la pestaña **Files**. 2. Haz clic en **Create Knowledge base**. 3. En el modal de subida, escribe un **Group Name** (obligatorio). 4. Añade tus documentos: * Arrastra y suelta los archivos en el área de subida, o * Haz clic en **Select Files** para buscarlos. 5. Haz clic en **Upload Files** para finalizar. Formatos y límites compatibles (tal como aparecen en el cargador): * PDF, DOC, DOCX, TXT * Máx. 5MB por archivo > **Error común:** Subir documentos no relacionados dentro del mismo grupo. Si tienes casos de uso diferentes (Ventas vs. Soporte), crea grupos separados para asignar el conocimiento correcto a cada agente. ### Administrar y actualizar archivos en un grupo Después de crear un grupo, puedes abrirlo para administrar lo que contiene: * Añadir más documentos (por ejemplo, usando **Add New Files**). * Ver la lista de **Current Files** ya incluidos. * Eliminar archivos que ya no quieres que el agente consulte. > **Consejo:** Usa nombres de grupo claros como **“Políticas de soporte”**, **“Precios y planes”** o **“Guion de admisión de clínica”** para que sea fácil seleccionar el grupo correcto más adelante. ## Base de conocimiento con Web URLs La pestaña **Web** sirve para enseñar al agente usando páginas web. Creas un **grupo de URLs**, le das un título y añades una o varias URLs. Esto es útil cuando tu fuente de verdad está en tu web (centro de ayuda, documentación, políticas, landing pages).Captura: La Base de conocimiento en modo Web, donde añades y gestionas grupos de URLs de tu sitio.
### Crear un grupo de URLs 1. Abre la pestaña **Web**. 2. Haz clic en **Add Web URL**. 3. Completa: * **Title** (obligatorio): el nombre del grupo de URLs (este título se usa para todas las URLs del grupo). * **URL #1**: pega el primer enlace de la página web. 4. (Opcional) Haz clic en **Add Another URL** para incluir más páginas. 5. Haz clic en **Add URL** para guardar el grupo. > **Consejo:** Mantén los grupos de URLs enfocados. Por ejemplo, un grupo para URLs de **“Precios y facturación”** y otro distinto para URLs de **“Política de reembolsos”**. ### Editar o eliminar un grupo de URLs Una vez creado un grupo de URLs, puedes gestionarlo desde la lista: * **Editar** el título del grupo y las URLs. * **Eliminar** el grupo si ya no lo necesitas. * Abrir el grupo para ver lo que incluye. Dentro del modal de edición, puedes: * Actualizar el **Title** * Añadir o eliminar URLs individuales * Hacer clic en **Save** para aplicar cambios > **Importante:** Si cambias las URLs y necesitas que un agente existente use el contenido actualizado, puede que tengas que reabrir el editor del agente y aplicar un **Update** en la sección de Base de conocimiento (esto puede variar según tu cuenta/plan). ## Seleccionar una Base de conocimiento para un agente Después de crear tus grupos (Files o Web URLs), los asignas a un agente durante la edición del agente.Captura: Selección de un grupo de Base de conocimiento al editar un agente de IA (elige Files o Web URLs y luego un grupo).
### Asignar un grupo a un agente 1. Ve a **AI Agents** y abre un agente para editarlo. 2. Busca la sección **Knowledge Base**. 3. Haz clic en **Add**. 4. Elige el **Source**: * **Files**, o * **Web URLs** 5. Selecciona un **Group** (por ejemplo: “Políticas de soporte” o “Docs del sitio de la empresa”). 6. Haz clic en **Select** para asignarlo al agente. También puede aparecer una opción **Refresh** para recargar la lista de grupos. > **Consejo:** Si tienes varios agentes con roles distintos, asigna a cada agente un grupo de Base de conocimiento diferente para que se mantengan enfocados y no respondan fuera de su alcance. ## Ejemplo práctico Imagina que tienes una clínica dental y dos agentes: * **Agente de recepción** (citas, horarios, cómo llegar) * **Agente de facturación** (precios, facturas, preguntas de seguros) Una buena configuración podría ser: * Grupo de archivos: **“FAQs de la clínica (TXT)”** para respuestas rápidas y guiones * Grupo de URLs web: **“Páginas de precios y seguros”** apuntando a páginas públicas de tu sitio Luego: * El **Agente de recepción** usa el grupo de FAQs. * El **Agente de facturación** usa el grupo de URLs de precios y seguros. # Base de connaissances Source: https://support.callin.io/Create-AI-Agent/Knowledbase-copied-2 Créez une bibliothèque partagée de fichiers et d’URL Web que vos agents IA peuvent consulter pour répondre plus précisément. ## À quoi sert la base de connaissances La **base de connaissances** est l’endroit où vous stockez des informations que vos agents IA peuvent utiliser pendant les conversations, afin de ne pas dépendre uniquement du prompt principal. Cas d’usage typiques : * Répondre aux questions sur votre activité (services, tarifs, politiques, horaires). * Guider les utilisateurs dans des processus (étapes de remboursement, préparation de rendez-vous, onboarding). * Assurer des réponses cohérentes sur plusieurs agents. Accédez-y ici : [Base de connaissances](https://app.callin.io/knowledge-base) > **Conseil :** Considérez la base de connaissances comme une « documentation de référence validée » que l’agent peut consulter quand quelqu’un pose des questions détaillées. ## Comment cela se relie aux agents IA Vous n’ajoutez pas le contenu directement dans un agent. À la place : 1. Vous construisez le contenu de la base de connaissances ici (Files ou Web URLs). 2. Ensuite, lors de l’édition d’un agent, vous **sélectionnez le groupe** de base de connaissances que vous voulez lui associer. > **Important :** Si vous mettez à jour un groupe de base de connaissances et souhaitez que les changements se reflètent sur un agent existant, il peut être nécessaire de retourner dans l’éditeur de l’agent et de cliquer sur une action **Update** dans la section base de connaissances (cela peut varier selon votre compte/forfait). ## Base de connaissances avec Files L’onglet **Files** sert à importer des documents dont l’agent doit apprendre (par exemple : une politique en PDF, un script en DOCX ou une FAQ en TXT). Les fichiers sont organisés en **groupes**, afin d’associer le bon ensemble de documents au bon agent.Capture : La base de connaissances en mode Files, où vous importez des documents et les organisez en groupes.
### Créer un groupe de fichiers et importer des documents 1. Ouvrez l’onglet **Files**. 2. Cliquez sur **Create Knowledge base**. 3. Dans la fenêtre d’import, renseignez un **Group Name** (obligatoire). 4. Ajoutez vos documents : * Glissez-déposez les fichiers dans la zone d’import, ou * Cliquez sur **Select Files** pour les parcourir. 5. Cliquez sur **Upload Files** pour terminer. Formats et limites pris en charge (tels qu’affichés dans l’importeur) : * PDF, DOC, DOCX, TXT * 5 Mo max par fichier > **Erreur fréquente :** Mettre plusieurs documents sans lien dans un seul groupe. Si vous avez des usages différents (Ventes vs Support), créez des groupes séparés afin d’associer la bonne connaissance à chaque agent. ### Gérer et mettre à jour les fichiers d’un groupe Une fois un groupe créé, vous pouvez l’ouvrir pour gérer son contenu : * Ajouter d’autres documents (par exemple via **Add New Files**). * Voir la liste des **Current Files** déjà inclus. * Supprimer les fichiers que vous ne voulez plus que l’agent consulte. > **Conseil :** Utilisez des noms de groupe explicites comme **« Politiques Support »**, **« Tarifs & Offres »** ou **« Script d’accueil clinique »** pour retrouver facilement le bon groupe ensuite. ## Base de connaissances avec Web URLs L’onglet **Web** sert à entraîner l’agent à partir de pages web. Vous créez un **groupe d’URL**, lui donnez un titre, puis ajoutez une ou plusieurs URL. C’est pratique lorsque votre source de vérité se trouve sur votre site (centre d’aide, documentation, politiques, pages publiques).Capture : La base de connaissances en mode Web, où vous ajoutez et gérez des groupes d’URL de site.
### Créer un groupe d’URL 1. Ouvrez l’onglet **Web**. 2. Cliquez sur **Add Web URL**. 3. Renseignez : * **Title** (obligatoire) : le nom du groupe d’URL (ce titre est utilisé pour toutes les URL du groupe). * **URL #1** : collez le lien de la première page. 4. (Optionnel) Cliquez sur **Add Another URL** pour ajouter d’autres pages. 5. Cliquez sur **Add URL** pour enregistrer le groupe. > **Conseil :** Gardez des groupes d’URL ciblés. Par exemple, un groupe pour **« Tarifs & Facturation »** et un autre pour **« Politique de remboursement »**. ### Modifier ou supprimer un groupe d’URL Une fois un groupe d’URL créé, vous pouvez le gérer depuis la liste : * **Modifier** le titre du groupe et les URL. * **Supprimer** le groupe si vous n’en avez plus besoin. * Ouvrir le groupe pour voir son contenu. Dans la fenêtre d’édition, vous pouvez : * Mettre à jour le **Title** * Ajouter ou retirer des URL individuellement * Cliquer sur **Save** pour appliquer les changements > **Important :** Si vous modifiez les URL et souhaitez qu’un agent existant utilise le contenu mis à jour, il peut être nécessaire de rouvrir l’éditeur de l’agent et d’appliquer un **Update** dans la section base de connaissances (cela peut varier selon votre compte/forfait). ## Sélectionner une base de connaissances pour un agent Après avoir créé vos groupes (Files ou Web URLs), vous les associez à un agent lors de l’édition de celui-ci.Capture : Sélection d’un groupe de base de connaissances lors de l’édition d’un agent IA (choisissez Files ou Web URLs, puis un groupe).
### Associer un groupe à un agent 1. Allez dans **AI Agents** et ouvrez un agent en édition. 2. Trouvez la section **Knowledge Base**. 3. Cliquez sur **Add**. 4. Choisissez la **Source** : * **Files**, ou * **Web URLs** 5. Sélectionnez un **Group** (par exemple : « Politiques Support » ou « Docs du site »). 6. Cliquez sur **Select** pour l’associer à l’agent. Vous pouvez aussi voir une option **Refresh** pour recharger la liste des groupes. > **Conseil :** Si vous avez plusieurs agents avec des rôles différents, attribuez à chacun un groupe de base de connaissances différent afin qu’ils restent focalisés et ne répondent pas en dehors de leur périmètre. ## Exemple concret Imaginons que vous gériez un cabinet dentaire avec deux agents : * **Agent d’accueil** (rendez-vous, horaires, itinéraire) * **Agent de facturation** (tarifs, factures, questions d’assurance) Une bonne configuration pourrait être : * Groupe de fichiers : **« FAQ du cabinet (TXT) »** pour les réponses rapides et les scripts * Groupe d’URL web : **« Pages Tarifs & Assurance »** pointant vers les pages publiques de votre site Ensuite : * L’**agent d’accueil** utilise le groupe de FAQ. * L’**agent de facturation** utilise le groupe d’URL Tarifs & Assurance. # Base di conoscenza Source: https://support.callin.io/Create-AI-Agent/Knowledbase-copied-3 Crea una libreria condivisa di file e URL web che i tuoi agenti IA possono consultare per rispondere in modo più accurato. ## A cosa serve la base di conoscenza La **base di conoscenza** è il luogo in cui memorizzi informazioni che i tuoi agenti IA possono usare durante le conversazioni, così non devono basarsi solo sul prompt principale. Casi d’uso tipici: * Rispondere a domande sulla tua attività (servizi, prezzi, policy, orari). * Guidare gli utenti nei processi (passaggi di rimborso, preparazione appuntamenti, onboarding). * Mantenere risposte coerenti su più agenti. Accedila qui: [Base di conoscenza](https://app.callin.io/knowledge-base) > **Suggerimento:** Pensa alla base di conoscenza come a “materiale di riferimento approvato” che l’agente può consultare quando qualcuno fa domande dettagliate. ## Come si collega agli agenti IA Non aggiungi i contenuti direttamente dentro un agente. Invece: 1. Crei i contenuti della base di conoscenza qui (Files o Web URLs). 2. Poi, mentre modifichi un agente, **selezioni il gruppo** di base di conoscenza che vuoi assegnargli. > **Importante:** Se aggiorni un gruppo della base di conoscenza e vuoi che le modifiche si riflettano su un agente esistente, potrebbe essere necessario tornare all’editor dell’agente e fare clic su un’azione **Update** nella sezione base di conoscenza (può variare in base a account/piano). ## Base di conoscenza con Files La scheda **Files** serve per caricare documenti da cui l’agente deve apprendere (ad esempio: una policy in PDF, uno script in DOCX o una FAQ in TXT). I file sono organizzati in **gruppi**, così puoi assegnare il set giusto di documenti all’agente giusto.Schermata: La base di conoscenza in modalità Files, dove carichi documenti e li organizzi in gruppi.
### Creare un gruppo di file e caricare documenti 1. Apri la scheda **Files**. 2. Fai clic su **Create Knowledge base**. 3. Nel modal di caricamento, inserisci un **Group Name** (obbligatorio). 4. Aggiungi i tuoi documenti: * Trascina e rilascia i file nell’area di caricamento, oppure * Fai clic su **Select Files** per selezionarli. 5. Fai clic su **Upload Files** per completare. Formati supportati e limiti (come mostrato nel caricatore): * PDF, DOC, DOCX, TXT * Max 5MB per file > **Errore comune:** Caricare più documenti non correlati nello stesso gruppo. Se hai casi d’uso diversi (Vendite vs Supporto), crea gruppi separati per assegnare la conoscenza corretta a ogni agente. ### Gestire e aggiornare i file di un gruppo Dopo che un gruppo esiste, puoi aprirlo per gestire cosa contiene: * Aggiungere altri documenti (ad esempio usando **Add New Files**). * Vedere l’elenco dei **Current Files** già inclusi. * Rimuovere file che non vuoi più far consultare all’agente. > **Suggerimento:** Usa nomi di gruppo chiari come **“Policy di supporto”**, **“Prezzi e piani”** o **“Script di accoglienza clinica”** per poter selezionare facilmente il gruppo giusto in seguito. ## Base di conoscenza con Web URLs La scheda **Web** serve per insegnare all’agente a partire da pagine web. Crei un **gruppo di URL**, gli dai un titolo e aggiungi uno o più URL. È utile quando la tua fonte di verità è sul tuo sito (help center, documentazione, policy, landing page).Schermata: La base di conoscenza in modalità Web, dove aggiungi e gestisci gruppi di URL del sito.
### Creare un gruppo di URL 1. Apri la scheda **Web**. 2. Fai clic su **Add Web URL**. 3. Compila: * **Title** (obbligatorio): il nome del gruppo di URL (questo titolo viene usato per tutti gli URL del gruppo). * **URL #1**: incolla il primo link della pagina web. 4. (Opzionale) Fai clic su **Add Another URL** per includere altre pagine. 5. Fai clic su **Add URL** per salvare il gruppo. > **Suggerimento:** Mantieni i gruppi di URL focalizzati. Ad esempio, un gruppo per **“Prezzi e fatturazione”** e un altro per **“Policy di rimborso”**. ### Modificare o eliminare un gruppo di URL Una volta creato un gruppo di URL, puoi gestirlo dall’elenco: * **Modificare** il titolo del gruppo e gli URL. * **Eliminare** il gruppo se non ti serve più. * Aprire il gruppo per vedere cosa include. Nel modal di modifica puoi: * Aggiornare il **Title** * Aggiungere o rimuovere singoli URL * Fare clic su **Save** per applicare le modifiche > **Importante:** Se modifichi gli URL e vuoi che un agente esistente usi i contenuti aggiornati, potrebbe essere necessario riaprire l’editor dell’agente e applicare un **Update** nella sezione base di conoscenza (può variare in base a account/piano). ## Selezionare una base di conoscenza per un agente Dopo aver creato i tuoi gruppi (Files o Web URLs), li assegni a un agente durante la modifica dell’agente.Schermata: Selezione di un gruppo di base di conoscenza mentre modifichi un agente IA (scegli Files o Web URLs e poi un gruppo).
### Assegnare un gruppo a un agente 1. Vai su **AI Agents** e apri un agente da modificare. 2. Trova la sezione **Knowledge Base**. 3. Fai clic su **Add**. 4. Scegli la **Source**: * **Files**, oppure * **Web URLs** 5. Seleziona un **Group** (ad esempio: “Policy di supporto” o “Documenti del sito aziendale”). 6. Fai clic su **Select** per assegnarlo all’agente. Potresti anche vedere un’opzione **Refresh** per ricaricare l’elenco dei gruppi. > **Suggerimento:** Se hai più agenti con ruoli diversi, assegna a ciascun agente un gruppo di base di conoscenza diverso, così restano focalizzati e non rispondono fuori ambito. ## Esempio pratico Immagina di gestire una clinica dentistica con due agenti: * **Agente di reception** (appuntamenti, orari, indicazioni) * **Agente di fatturazione** (prezzi, fatture, domande sulle assicurazioni) Una buona configurazione potrebbe essere: * Gruppo di file: **“FAQ della clinica (TXT)”** per risposte rapide e script * Gruppo di URL web: **“Pagine prezzi e assicurazioni”** che puntano alle pagine pubbliche del tuo sito Poi: * L’**agente di reception** usa il gruppo FAQ. * L’**agente di fatturazione** usa il gruppo di URL prezzi e assicurazioni. # Wissensdatenbank Source: https://support.callin.io/Create-AI-Agent/Knowledbase-copied-4 Erstellen Sie eine gemeinsame Bibliothek aus Dateien und Web-URLs, auf die Ihre KI-Agenten zugreifen können, um präziser zu antworten. ## Wofür die Wissensdatenbank gedacht ist Die **Wissensdatenbank** ist der Ort, an dem Sie Informationen speichern, die Ihre KI-Agenten während Gesprächen nutzen können – damit sie nicht nur vom Haupt-Prompt abhängen. Typische Anwendungsfälle: * Fragen zu Ihrem Unternehmen beantworten (Leistungen, Preise, Richtlinien, Öffnungszeiten). * Nutzer durch Prozesse führen (Erstattungsschritte, Terminvorbereitung, Onboarding). * Konsistente Antworten über mehrere Agenten hinweg sicherstellen. Zugriff hier: [Wissensdatenbank](https://app.callin.io/knowledge-base) > **Tipp:** Sehen Sie die Wissensdatenbank als „freigegebenes Referenzmaterial“, das der Agent heranziehen kann, wenn jemand detaillierte Fragen stellt. ## Wie das mit KI-Agenten zusammenhängt Sie fügen Inhalte nicht direkt in einen Agenten ein. Stattdessen: 1. Sie bauen Ihre Wissensdatenbank hier auf (Files oder Web URLs). 2. Danach wählen Sie beim Bearbeiten eines Agenten die **Gruppe** aus, die dieser Agent verwenden soll. > **Wichtig:** Wenn Sie eine Wissensdatenbank-Gruppe aktualisieren und die Änderungen bei einem bestehenden Agenten sichtbar sein sollen, müssen Sie möglicherweise zum Agent-Editor zurückkehren und in der Wissensdatenbank-Sektion eine **Update**-Aktion ausführen (kann je nach Konto/Plan variieren). ## Wissensdatenbank mit Files Der Tab **Files** ist zum Hochladen von Dokumenten gedacht, aus denen der Agent lernen soll (z. B. eine Richtlinie als PDF, ein Skript als DOCX oder eine FAQ als TXT). Dateien werden in **Gruppen** organisiert, damit Sie dem richtigen Agenten den richtigen Dokumentensatz zuweisen können.Screenshot: Die Wissensdatenbank im Files-Modus, in dem Sie Dokumente hochladen und in Gruppen organisieren.
### Eine Dateigruppe erstellen und Dokumente hochladen 1. Öffnen Sie den Tab **Files**. 2. Klicken Sie auf **Create Knowledge base**. 3. Geben Sie im Upload-Modal einen **Group Name** ein (erforderlich). 4. Fügen Sie Ihre Dokumente hinzu: * Dateien per Drag-and-Drop in den Upload-Bereich ziehen, oder * **Select Files** klicken, um sie auszuwählen. 5. Klicken Sie auf **Upload Files**, um abzuschließen. Unterstützte Formate und Limits (wie im Uploader angezeigt): * PDF, DOC, DOCX, TXT * Max. 5MB pro Datei > **Häufiger Fehler:** Mehrere themenfremde Dokumente in eine Gruppe zu packen. Wenn Sie unterschiedliche Anwendungsfälle haben (Sales vs. Support), erstellen Sie getrennte Gruppen, damit jeder Agent das passende Wissen bekommt. ### Dateien in einer Gruppe verwalten und aktualisieren Sobald eine Gruppe existiert, können Sie sie öffnen und den Inhalt verwalten: * Weitere Dokumente hinzufügen (z. B. über **Add New Files**). * Die Liste der **Current Files** ansehen. * Dateien entfernen, die der Agent nicht mehr nutzen soll. > **Tipp:** Verwenden Sie klare Gruppennamen wie **„Support-Richtlinien“**, **„Preise & Pläne“** oder **„Klinik-Intake-Skript“**, damit Sie später schnell die richtige Gruppe auswählen. ## Wissensdatenbank mit Web URLs Der Tab **Web** ist dafür da, den Agenten mit Webseiten zu versorgen. Sie erstellen eine **URL-Gruppe**, vergeben einen Titel und fügen eine oder mehrere URLs hinzu. Das ist hilfreich, wenn Ihre „Single Source of Truth“ auf Ihrer Website liegt (Help Center, Doku, Richtlinien, Landingpages).Screenshot: Die Wissensdatenbank im Web-Modus, in dem Sie Website-URLs als Gruppen hinzufügen und verwalten.
### Eine URL-Gruppe erstellen 1. Öffnen Sie den Tab **Web**. 2. Klicken Sie auf **Add Web URL**. 3. Tragen Sie ein: * **Title** (erforderlich): der Name der URL-Gruppe (dieser Titel gilt für alle URLs in der Gruppe). * **URL #1**: fügen Sie den Link zur ersten Webseite ein. 4. (Optional) Klicken Sie auf **Add Another URL**, um weitere Seiten hinzuzufügen. 5. Klicken Sie auf **Add URL**, um die Gruppe zu speichern. > **Tipp:** Halten Sie URL-Gruppen fokussiert. Zum Beispiel eine Gruppe für **„Preise & Abrechnung“** und eine andere für **„Erstattungsrichtlinie“**. ### Eine URL-Gruppe bearbeiten oder löschen Sobald eine URL-Gruppe erstellt wurde, können Sie sie in der Liste verwalten: * Den Gruppentitel und die URLs **bearbeiten**. * Die Gruppe **löschen**, wenn Sie sie nicht mehr benötigen. * Die Gruppe öffnen, um zu sehen, was enthalten ist. Im Bearbeitungs-Modal können Sie: * Den **Title** aktualisieren * Einzelne URLs hinzufügen oder entfernen * Auf **Save** klicken, um Änderungen zu übernehmen > **Wichtig:** Wenn Sie URLs ändern und ein bestehender Agent die aktualisierten Inhalte nutzen soll, müssen Sie möglicherweise den Agent-Editor erneut öffnen und in der Wissensdatenbank-Sektion ein **Update** anwenden (kann je nach Konto/Plan variieren). ## Eine Wissensdatenbank für einen Agenten auswählen Nachdem Sie Ihre Gruppen (Files oder Web URLs) erstellt haben, ordnen Sie sie einem Agenten während der Bearbeitung zu.Screenshot: Auswahl einer Wissensdatenbank-Gruppe beim Bearbeiten eines KI-Agenten (Files oder Web URLs wählen und anschließend eine Gruppe auswählen).
### Eine Gruppe einem Agenten zuweisen 1. Gehen Sie zu **AI Agents** und öffnen Sie einen Agenten zur Bearbeitung. 2. Suchen Sie den Abschnitt **Knowledge Base**. 3. Klicken Sie auf **Add**. 4. Wählen Sie die **Source**: * **Files**, oder * **Web URLs** 5. Wählen Sie eine **Group** (z. B. „Support-Richtlinien“ oder „Website-Dokumentation“). 6. Klicken Sie auf **Select**, um die Gruppe dem Agenten zuzuweisen. Möglicherweise sehen Sie außerdem **Refresh**, um die Gruppenliste neu zu laden. > **Tipp:** Wenn Sie mehrere Agenten mit unterschiedlichen Rollen haben, weisen Sie jedem Agenten eine eigene Wissensdatenbank-Gruppe zu, damit sie fokussiert bleiben und nicht außerhalb ihres Aufgabenbereichs antworten. ## Praxisbeispiel Angenommen, Sie betreiben eine Zahnarztpraxis mit zwei Agenten: * **Empfangs-Agent** (Termine, Öffnungszeiten, Wegbeschreibung) * **Abrechnungs-Agent** (Preise, Rechnungen, Versicherungsfragen) Eine sinnvolle Struktur wäre: * Dateigruppe: **„Praxis-FAQs (TXT)“** für schnelle Antworten und Skripte * Web-URL-Gruppe: **„Preis- & Versicherungsseiten“** mit Links auf öffentliche Seiten Ihrer Website Dann: * Der **Empfangs-Agent** nutzt die FAQ-Gruppe. * Der **Abrechnungs-Agent** nutzt die Preis- & Versicherungs-URLs. # Before You Build: How AI Call Agents Work Source: https://support.callin.io/Create-AI-Agent/introduction Understand what AI Call Agents are, how they work, and how to connect numbers, costs, and integrations before building your first one.La lista de agentes de correo. Cada agente muestra su nombre, su fecha de creación y un aviso en naranja mientras no tenga ninguna bandeja conectada.
Se abre un asistente de configuración corto que te acompaña por los mismos ajustes que ves en los siguientes pasos de esta guía: nombre, instrucciones, categorías, reglas de automatización y bandeja. No te preocupes por dejarlo todo perfecto a la primera: todos los pasos salvo el nombre se pueden saltar, y luego puedes cambiar cualquier cosa desde las pestañas de configuración del agente. Ponle un nombre que te diga de un vistazo de qué se encarga, por ejemplo "Atención al cliente" o "Bandeja de ventas". Tienes hasta 50 caracteres, y este nombre aparece en todos los sitios donde aparece el agente, así que mejor claro que ingenioso. Puedes cambiarlo cuando quieras desde el campo de texto en la parte superior de la pantalla del agente. Debajo del nombre, en la lista, verás **Sin correo asignado** en naranja. Es normal: solo significa que todavía no hay ninguna bandeja conectada. Lo resolverás en el paso 4. Cada fila de la lista tiene además un menú **⋮** con tres acciones: **Copiar ID** copia el identificador único del agente, **Editar** abre su configuración y **Eliminar** borra el agente de forma permanente tras una confirmación. Eliminar un agente solo borra su configuración y su conexión: tu cuenta de correo y los mensajes que contiene no se tocan. Una vez existe el agente, su configuración se organiza en cuatro pestañas: **Agente**, **Categorías**, **Buzón** y **Avanzado**. Los siguientes pasos las recorren en ese orden. ## Paso 2 — Dile al agente cómo comportarse Abre la pestaña **Agente**. Aquí defines la personalidad y el criterio del agente. ### Prompt de conversación El **prompt de conversación** es un cuadro donde escribes, en lenguaje normal, cómo debe gestionar el correo el agente. No hay ninguna sintaxis especial: lo escribes igual que le explicarías el trabajo a un compañero nuevo en su primer día. Un ejemplo corto: > Responde de forma profesional y pasa las preguntas de facturación a una persona. Cuanto más concreto seas, más predecible será el resultado. Una versión más útil para una clínica dental sería: "Respondes en nombre de Clínica Dental Demo. Sé cercano y breve. Responde preguntas sobre horario, dirección y precios. Si alguien pide cambiar una cita, dile que hoy mismo le escribirá una persona del equipo y no prometas una hora concreta". El contador de la esquina inferior derecha del cuadro te indica cuánto espacio has usado de los 4000 caracteres disponibles. Es de sobra para unas instrucciones muy detalladas. Cualquier cambio que guardes aquí se aplica de inmediato al correo nuevo que entre. > **Consejo:** Escribe también lo que el agente **no** debe hacer, no solo lo que sí. Frases como "nunca confirmes citas", "nunca prometas devoluciones" o "nunca hables de precios por correo" te evitan casi todas las sorpresas. ### Inteligencia IA (LLM) A la derecha de esa misma pestaña verás **Inteligencia IA (LLM)**. Un **LLM** (modelo grande de lenguaje) es el motor que lee y escribe texto: es la parte que realmente entiende el correo y redacta la respuesta. Haz clic en la tarjeta del modelo para abrir un panel lateral con las opciones disponibles. Junto a cada modelo verás una etiqueta que indica su nivel de razonamiento, es decir, cuánto "piensa" el modelo antes de escribir. Más razonamiento aporta más matices, pero también más tiempo y más coste por respuesta. | Modelo | Nivel de razonamiento | Para qué va bien | | ------------- | --------------------- | ----------------------------------------------------------------------------- | | GPT 5.4 Mini | Bajo | La opción por defecto, equilibrada en calidad, velocidad y coste | | Claude Sonnet | Medio | Respuestas donde el tono importa más, con una voz cuidada y natural | | GPT 5.4 Nano | Bajo | Grandes volúmenes de correo sencillo, donde pesan más la velocidad y el coste | | GPT 4.1 Mini | Bajo | Una opción estable y equilibrada para un tráfico alto y constante | En ese mismo panel encontrarás la **temperatura**, un control deslizante de 0 a 1 que empieza en 0,7. Regula cómo de creativas o predecibles son las respuestas del agente. Los valores bajos mantienen una redacción constante y repetible, útil cuando las respuestas deben seguir una plantilla. Los valores altos hacen la redacción más variada y natural, a cambio de más diferencias entre mensajes parecidos. > **Si es tu primera vez:** No tienes que tocar nada de esto. El modelo y la temperatura por defecto funcionan bien para la mayoría de bandejas. Vuelve más adelante: si las respuestas suenan robóticas, prueba Claude Sonnet o sube un poco la temperatura; si varían demasiado, bájala. ## Paso 3 — Organiza tu correo con categorías Abre la pestaña **Categorías**. Las categorías son etiquetas opcionales que ayudan al agente a entender con qué tipo de mensaje está tratando: facturas, quejas, peticiones de cita, etc. Cada categoría existente aparece como una tarjeta con su etiqueta, su descripción y un icono de lápiz para editarla o de papelera para eliminarla. Merece la pena configurarlas porque te permiten tratar cada tipo de correo de forma distinta. Quizá quieras que el agente responda solo a una pregunta sencilla sobre el horario, pero que se limite a preparar un borrador cuando el mensaje hable de dinero. Haz clic en **Añadir categoría**. Se abre una ventana con estos campos: | Campo | Qué hace | Ejemplo | | ---------------------- | ------------------------------------------------------- | ----------------------------- | | Nombre de la categoría | La etiqueta corta que verás en cada correo | Facturación | | Descripción | Le indica al agente cuándo usar esta categoría | Facturas, pagos, devoluciones | | Color de la etiqueta | El color de la etiqueta, para reconocerla de un vistazo | Rosa | Puedes elegir uno de los colores predefinidos o crear el tuyo con la muestra **+**. Debajo hay dos interruptores: * **Generar borrador de respuesta para esta categoría**: activado por defecto. El agente prepara la respuesta y te la deja lista para que la revises antes de que salga. * **Respuesta automática para esta categoría**: desactivado por defecto. El agente envía la respuesta él mismo, sin revisión. Si desactivas los dos, el agente sigue etiquetando el mensaje con la categoría pero no escribe ninguna respuesta. Es útil para el correo que siempre quieres que gestione una persona desde cero, como quejas o asuntos legales. > **Error común:** Escribir una descripción demasiado vaga, del estilo "cosas importantes". El agente usa ese texto para decidir qué correos entran aquí, así que describe el contenido real: "mensajes que piden una factura, una devolución o un cambio de método de pago". Si ves que los correos caen en la categoría equivocada, afinar la descripción suele ser el arreglo más rápido. > **Importante:** Empieza con **Generar borrador de respuesta** activado y **Respuesta automática** desactivado. Lee los borradores durante unos días. Cuando compruebes que el agente acierta con el tono y con los datos, activa la respuesta automática en las categorías donde un error no tendría consecuencias. ## Paso 4 — Conecta la bandeja Abre la pestaña **Buzón**. Aquí enlazas la cuenta de correo real de la que se va a ocupar el agente. Hasta que lo hagas, el agente está configurado pero parado. Tienes tres opciones: * **Gmail**: conecta con tu cuenta de Google. Apruebas la conexión en la pantalla de permisos habitual de Google, sin configurar nada a mano. * **Outlook**: conecta con Microsoft 365, de la misma forma que Gmail. * **Otro correo (IMAP y SMTP)**: conecta cualquier otro proveedor. **IMAP** es el estándar que permite al agente leer el correo de tu bandeja, y **SMTP** es el que le permite enviar las respuestas. Tu proveedor publica ambos datos en sus páginas de ayuda. Si eliges la opción manual, el formulario te pide: | Campo | Qué poner | | ------------------------- | ------------------------------------------------------------------------------------------------- | | Dirección de correo | La bandeja de la que el agente leerá y desde la que enviará | | Contraseña | Tu contraseña o, mejor, una contraseña de aplicación si tu cuenta tiene verificación en dos pasos | | Servidor IMAP | El servidor de lectura, algo como imap.tuproveedor.com | | Puerto IMAP | Normalmente 993, que el formulario sugiere por defecto | | Días de correo a importar | Hasta dónde mira atrás el agente al conectar por primera vez, de 1 a 45 días | | Servidor SMTP | El servidor de envío, algo como smtp.tuproveedor.com | | Puerto SMTP | Normalmente 587, que el formulario sugiere por defecto | Bajo las opciones, la pantalla te recuerda que tus credenciales se guardan cifradas y de forma segura. > **Nota:** Puedes saltarte este paso y conectar la bandeja más tarde. Todo lo que configuraste en los pasos anteriores se mantiene guardado. Eso sí, recuerda que el agente no procesará absolutamente nada hasta que haya una bandeja enlazada. ## Paso 5 — Ajusta el comportamiento (opcional) Abre la pestaña **Avanzado**. Todo lo que hay aquí es opcional, y las dos reglas empiezan desactivadas. Si este es tu primer agente, puedes saltar al paso 6 sin problema y volver otro día. ### Reglas de automatización **Responder solo a un remitente concreto.** Cuando lo activas y escribes una dirección en **Dirección de correo del remitente**, el agente solo procesa y responde los mensajes que llegan de esa dirección. El resto de remitentes se ignoran por completo, y las categorías pasan a ser opcionales. Es perfecto para automatizaciones estrechas y de un solo propósito — responder siempre a un sistema automático o a un contacto concreto — y también es la forma más segura de probar un agente en una bandeja real: apúntalo a tu propia dirección y observa qué hace, sin tocar a ningún cliente. **Copiar respuestas automáticas.** Envía una copia de cada respuesta automática a una dirección adicional, que escribes en **Correo del destinatario en copia**. En **Tipo de envío** eliges cómo viaja esa copia: * **CC (visible)**: la persona que recibe la respuesta ve esa dirección en la línea de copia. * **CCO (oculto)**: la copia se envía en silencio y el destinatario no ve nada. Resulta útil cuando un responsable quiere seguir de cerca lo que envía el agente. > **Consejo:** Si activas la respuesta automática en alguna categoría, activa también la copia, al menos mientras vas cogiendo confianza en lo que escribe el agente. > **Advertencia:** Si la copia va a un compañero interno, elige **CCO (oculto)**. Con **CC (visible)**, tu cliente ve el correo de tu compañero en cada mensaje. ### Prioridad de agentes Cuando varios agentes comparten la misma bandeja, el primer agente que encaja con un correo es el que se ocupa de él: el mensaje no pasa por los demás. Esta sección te permite reordenar los agentes con flechas arriba y abajo. Ordénalos del más específico al más general: un agente limitado a un solo remitente debería ir por encima de un agente general de soporte, para que el agente comodín no se quede con todos los mensajes. Solo podrás cambiar el orden cuando haya una bandeja conectada. Hasta entonces, la pantalla te indica que conectes una en la pestaña **Buzón**. ## Paso 6 — Guarda los cambios Cuando tienes cambios sin guardar aparece una barra en la parte inferior de la pantalla con dos botones: **Descartar**, que deshace todo lo que acabas de cambiar, y **Guardar**, que lo almacena. > **Importante:** No salgas de la pantalla mientras esa barra esté visible. Si te vas sin hacer clic en **Guardar**, pierdes los cambios. ## La sección Correo: lee y responde en un solo lugar Abre **Correo** en la barra lateral izquierda. Esta es la bandeja unificada: aquí aparecen los mensajes procesados por tus agentes, de todas las bandejas conectadas, con la categoría que ha recibido cada uno. Es también donde revisas, editas y envías los borradores que han preparado tus agentes. Si todavía no has conectado ninguna bandeja, la pantalla te explica exactamente qué falta y cómo resolverlo en tres pasos: abre **Agentes de correo** y selecciona un agente, conecta la bandeja en la pestaña **Buzón** con Google, con Microsoft o mediante IMAP, y vuelve aquí para leer y responder los mensajes. Los dos botones de esa pantalla, **Ir a Agentes de correo** y **Crear agente de correo**, te llevan directamente allí.La sección Correo antes de conectar ninguna bandeja. La propia pantalla te guía por los tres pasos que faltan.
Cuando haya una bandeja conectada, los mensajes entrantes aparecerán aquí a los pocos minutos de llegar, junto con los borradores y respuestas que haya preparado tu agente. ## La sección Herramientas: dale superpoderes a tus agentes Abre **Herramientas** en la barra lateral izquierda. Aquí conectas servicios externos que amplían lo que tus agentes pueden hacer con cada correo, dándoles acceso a datos en vivo que no están en la propia conversación. ### Amazon Seller API Con esta integración conectada, cuando el correo de un cliente contiene un número de pedido de Amazon, el agente consulta los detalles del pedido automáticamente y puede usarlos en su respuesta, en lugar de pedirle al cliente información que el sistema ya tiene.La sección Herramientas con la integración Amazon Seller API conectada. La tarjeta muestra los datos de la cuenta y el estado de la conexión.
Cuando la integración está activa, su tarjeta muestra una insignia verde de **Conectado** junto con los detalles de la conexión: el nombre de la cuenta de vendedor, el identificador de socio de venta, la región, el mercado y la fecha en que se conectó. Desde la misma tarjeta puedes escribir un número de pedido real en **ID de pedido de prueba** y pulsar **Probar conexión** para comprobar que todo funciona sin esperar al correo de un cliente, o usar **Desconectar** para desvincularla. En algunas cuentas esta integración se configura automáticamente con una configuración gestionada por el servidor. Si tu tarjeta ya dice **Conectado** y menciona la configuración del servidor, no tienes que hacer nada. ### Añadir enlaces de seguimiento a las respuestas Los datos del pedido están disponibles para el agente, pero no aparecerán en una respuesta si no le dices que los use. Para eso, menciónalos en el prompt de conversación usando variables: marcadores entre llaves dobles que se sustituyen por el valor real de cada pedido. Por ejemplo, añade esto al prompt: > Cuando el cliente pregunte por el envío o la entrega, incluye este enlace de seguimiento: Estas son las variables disponibles: | Variable | Por qué se sustituye | | ----------------------------- | -------------------- | | El número de pedido de Amazon | | | | El estado del pedido | | El mercado o país de venta | | | El país de destino | | | El país de envío | | | El número de seguimiento | | | El enlace de seguimiento | | | El transportista | | | El servicio de envío | | > **Nota:** Para que el enlace de seguimiento se rellene, la integración debe estar conectada, el hilo de correo debe contener un número de pedido de Amazon reconocible y el pedido debe estar ya enviado: los datos de seguimiento solo existen cuando Amazon los genera. Se espera que lleguen más herramientas a esta sección a medida que el Gestor de Correo con IA salga de la fase Beta. ## Cómo comprobar que funciona Tres señales rápidas de que todo está en su sitio: 1. En la lista de **Agentes de correo**, tu agente ya no muestra **Sin correo asignado** debajo del nombre. 2. Envía un correo de prueba a la bandeja conectada desde otra dirección tuya, con un texto que encaje con alguna de tus categorías. 3. Espera unos minutos y abre la sección **Correo**. Según cómo hayas configurado esa categoría, deberías encontrar un borrador listo para revisar o una respuesta ya enviada. Si no pasa nada, comprueba tres cosas por orden: que la bandeja está realmente conectada, que no tienes activado **Responder solo a un remitente concreto** apuntando a una dirección distinta de la que usaste en la prueba, y que tu correo de prueba encaja de verdad con la descripción de alguna categoría: la respuesta automática solo sale cuando el mensaje se clasifica en una categoría con la respuesta automática activada. ## Qué hacer después * Crea un par de categorías más ahora que has visto el agente en acción. Los correos reales siempre sugieren etiquetas en las que no habías pensado. * Visita la sección **Correo** cada día durante la primera semana para revisar los borradores de tu agente y pulir el prompt de conversación con lo que aprendas. * Echa un vistazo a **Herramientas** de vez en cuando: pueden aparecer integraciones nuevas a medida que el producto crece. # AI Email Manager Source: https://support.callin.io/Mail-Agent Agents, Email and Tools. Discover the AI Email Manager section of Callin.io and set up an agent that reads, sorts and replies to your email, step by step. **AI Email Manager** is the section of Callin.io where your AI stops making calls and starts handling email. It works around three areas, which you'll find in the left sidebar: * **Mail Agents** — where you create and configure the agents that manage your mail. * **Email** — where you read and reply to the messages your agents have processed. * **Tools** — where you connect third-party services that give your agents extra powers. A **Mail Agent** is an assistant that watches an inbox for you. It reads each new message, works out what it's about, and prepares a reply following the instructions you give it. You decide how far it goes: it can leave a draft waiting for you to review, or send the reply on its own. Each agent is connected to one inbox at a time, but several agents can share the same inbox and split the work between them. This guide walks through the three areas in order. Setting up your first agent takes about ten minutes and you don't need any technical background. > **Note:** AI Email Manager is marked as **Beta**. That means it's still growing, so some screens may look slightly different in your account. ## What you need before you start * The email account you want the agent to work with. It can be Gmail, Outlook, or almost any other provider. * If that account has two-factor authentication and you're not using Gmail or Outlook, an **app password**: a special password your provider generates for connecting external apps, so you never share your real one. * A rough idea of what you want the agent to do. One sentence is enough for now, for example: "answer questions about opening hours and pass anything about invoices to a person". You don't need the inbox ready right this second. You can build the agent first and connect the inbox later. ## Step 1 — Create the agent In the left sidebar, open **Mail Agents**. This is the list of every agent you've built. Click **Create Agent** in the top right.The Mail Agents list. Each agent shows its name, its creation date, and a warning in orange while it has no inbox connected yet.
A short setup wizard opens and walks you through the same settings covered in the next steps of this guide: name, instructions, categories, automation rules and inbox. Don't worry about getting everything right the first time — every step after the name can be skipped, and you can change anything later from the agent's configuration tabs. Give the agent a name that tells you at a glance what it handles, such as "Customer Support" or "Sales Inbox". You have up to 50 characters, and this name appears everywhere the agent does, so favour clarity over cleverness. You can rename it whenever you want from the text field at the top of the agent's screen. Under the name in the list you'll see **No email assigned** in orange. That's normal: it simply means no inbox is connected yet. You'll fix that in step 4. Each row in the list also has a **⋮** menu with three actions: **Copy ID** copies the agent's unique identifier, **Edit** opens its configuration, and **Delete** removes the agent permanently after a confirmation. Deleting an agent only removes its configuration and its connection — your email account and the messages in it are untouched. Once the agent exists, its configuration is organised into four tabs: **Agent**, **Categories**, **Mailbox** and **Advanced**. The next steps follow them in order. ## Step 2 — Tell the agent how to behave Open the **Agent** tab. This is where you shape the agent's personality and judgement. ### Conversation Prompt The **Conversation Prompt** is a box where you write, in plain language, how the agent should handle email. There's no special syntax: you write it the way you'd brief a new colleague on their first day. A short example: > Respond professionally and forward billing questions to a human. The more precise you are, the more predictable the results. A more useful version for a dental clinic might be: "You answer on behalf of Demo Dental Clinic. Be friendly and brief. Answer questions about opening hours, address and prices. If someone asks to change an appointment, tell them a member of staff will get back to them today, and don't promise a specific time." The counter in the bottom right of the box shows how much space you've used out of 4000 characters. That's plenty for a very detailed brief. Any change you save here applies immediately to new incoming mail. > **Tip:** Write down what the agent must **not** do, not just what it should do. Sentences like "never confirm appointments", "never promise refunds" or "never discuss prices over email" prevent most surprises. ### AI Intelligence (LLM) On the right side of the same tab you'll see **AI Intelligence (LLM)**. An **LLM** (large language model) is the engine that reads and writes text: it's the part that actually understands the email and drafts the answer. Click the model card to open a side panel with the choices available. Next to each model you'll see a label such as **(Low)** or **(Medium)**: that's its reasoning effort, meaning how much the model "thinks" before writing. More effort brings more nuance, but also more time and cost per reply. | Model | Reasoning effort | What it's good for | | ------------- | ---------------- | ------------------------------------------------------------------------- | | GPT 5.4 Mini | Low | The default option, balancing quality, speed and cost | | Claude Sonnet | Medium | Replies where tone matters most, with a polished, natural email voice | | GPT 5.4 Nano | Low | High volumes of simple mail, where speed and cost matter more than nuance | | GPT 4.1 Mini | Low | A stable, balanced option for steady, high-volume traffic | In that same panel you'll find **Temperature**, a slider from 0 to 1 that starts at 0.7. It controls how creative or predictable the agent's replies are. Lower values keep the wording consistent and repeatable — useful when replies must follow a template. Higher values make the phrasing more varied and natural, at the cost of more variation between similar messages. > **For beginners:** You don't have to touch any of this. The default model and temperature work well for most inboxes. Come back later: if replies feel robotic, try Claude Sonnet or raise the temperature a little; if they vary too much, lower it. ## Step 3 — Organise your mail with categories Open the **Categories** tab. Categories are optional labels that help the agent understand what kind of message it's dealing with: invoices, complaints, appointment requests, and so on. Each existing category appears as a card with its badge, its description, and a pencil icon to edit it or a bin icon to delete it. They're worth setting up because they let you treat each kind of email differently. You may want the agent to reply on its own to a simple question about opening hours, but only prepare a draft when the message is about money. Click **Add category**. A window opens with these fields: | Field | What it does | Example | | ------------- | ------------------------------------------------------- | --------------------------- | | Category name | The short label you'll see on each email | Billing | | Description | Tells the agent when to use this category | Invoices, payments, refunds | | Badge color | The colour of the label, so you can spot it at a glance | Pink | You can pick one of the preset colours or create your own with the **+** swatch. Below those there are two switches: * **Generate draft reply for this category** — switched on by default. The agent prepares a reply and leaves it ready for you to review before it goes out. * **Auto-reply for this category** — switched off by default. The agent sends the reply itself, with no review. If you switch both off, the agent still labels the message with the category but writes no reply at all. That's useful for mail you always want a human to handle from scratch, like complaints or legal matters. > **Common mistake:** Writing a description that's too vague, like "important stuff". The agent uses that text to decide which emails belong here, so describe the actual content: "messages asking for an invoice, a refund, or a change of payment method". If you notice emails landing in the wrong category, tightening the description is usually the fastest fix. > **Important:** Start with **Generate draft reply** switched on and **Auto-reply** switched off. Read the drafts for a few days. Once you're confident the agent gets the tone and the facts right, turn on automatic replies for the categories where mistakes would be harmless. ## Step 4 — Connect the inbox Open the **Mailbox** tab. This is where you link the actual email account the agent will look after. Until you do, the agent is configured but idle. You have three options: * **Gmail** — connect with your Google account. You approve the connection on Google's usual permission screen, with nothing to configure by hand. * **Outlook** — connect with Microsoft 365, in the same way as Gmail. * **Other email (IMAP & SMTP)** — connect any other provider. **IMAP** is the standard that lets the agent read the mail in your inbox, and **SMTP** is the one that lets it send replies. Your provider publishes both settings in its help pages. If you choose the manual option, the form asks for: | Field | What to enter | | ---------------------- | --------------------------------------------------------------------------------------- | | Email address | The inbox the agent will read from and send from | | Password | Your password, or better, an app password if your account has two-factor authentication | | IMAP host | The reading server, something like imap.yourprovider.com | | IMAP port | Usually 993, which the form suggests by default | | Days of mail to import | How far back the agent looks on first connection, from 1 to 45 days | | SMTP host | The sending server, something like smtp.yourprovider.com | | SMTP port | Usually 587, which the form suggests by default | Under the options the screen reminds you that your credentials are encrypted and stored securely. > **Note:** You can skip this step and connect the inbox later. Everything you configured in the previous steps stays saved. Just remember the agent won't process anything at all until an inbox is linked. ## Step 5 — Fine-tune the behaviour (optional) Open the **Advanced** tab. Everything here is optional, and both rules start switched off. If this is your first agent, you can safely skip to step 6 and come back another day. ### Automation rules **Reply only to a specific sender.** When you switch this on and type an address in **Sender email address**, the agent only processes and replies to messages from that address. Every other sender is skipped entirely, and categories become optional. It's perfect for narrow, single-purpose automations — always answering one automated system or one specific contact — and it's also the safest way to test an agent in a live inbox: point it at your own address and watch what it does, without touching real customers. **Copy automatic replies.** Sends a copy of every automatic reply to an extra address, which you type into **Copy recipient email**. Under **Delivery type** you choose how the copy travels: * **CC (visible)** — the person who receives the reply can see that address in the copy line. * **BCC (hidden)** — the copy is sent silently and the recipient sees nothing. This is handy when a manager wants to keep an eye on what the agent is sending. > **Tip:** If you enable automatic replies in any category, enable the copy as well, at least while you're building trust in the agent's output. > **Warning:** If the copy is going to an internal colleague, choose **BCC (hidden)**. With **CC (visible)** your customer sees your co-worker's email address in every message. ### Agent priority When several agents share the same inbox, the first agent that matches an email is the one that handles it — the message doesn't pass through the rest. This section lets you reorder the agents with up and down arrows. Order them from most specific to most general: an agent restricted to a single sender should sit above a general support agent, so the catch-all one doesn't claim every message first. You'll only be able to change the order once an inbox is connected. Until then, the screen tells you to connect one on the **Mailbox** tab. ## Step 6 — Save your changes When you have unsaved changes, a bar appears at the bottom of the screen with two buttons: **Discard**, which undoes everything you just changed, and **Save**, which stores it. > **Important:** Don't leave the screen while that bar is visible. If you navigate away without clicking **Save**, your changes are lost. ## The Email section: read and reply in one place Open **Email** in the left sidebar. This is the unified inbox: the messages processed by your agents show up here, across every connected mailbox, with the category each one received. It's also where you review, edit and send the draft replies your agents have prepared. If you haven't connected an inbox yet, the screen explains exactly what's missing and how to fix it in three steps: open **Mail Agents** and select an agent, connect Google, Microsoft or IMAP in the **Mailbox** tab, and come back here to read and reply to messages. The two buttons on that screen, **Go to Mail Agents** and **Create mail agent**, take you straight there.The Email section before any inbox is connected. The screen itself guides you through the three steps left to complete.
Once an inbox is connected, incoming messages appear here a few minutes after they arrive, along with the drafts and replies your agent has prepared. ## The Tools section: give your agents superpowers Open **Tools** in the left sidebar. Here you connect third-party services that extend what your agents can do with each email, giving them access to live data beyond the conversation itself. ### Amazon Seller API With this integration connected, when a customer email contains an Amazon order number, the agent looks up the order details automatically and can use them in its reply, instead of asking the customer for information the system already has.The Tools section with the Amazon Seller API integration connected. The card shows the account details and the connection status.
When the integration is active, its card shows a green **Connected** badge along with the connection details: the seller account name, the Selling Partner ID, the region, the marketplace and the date it was connected. From the same card you can type a real order number into **Test order ID** and press **Test connection** to check everything works without waiting for a customer email, or use **Disconnect** to unlink it. In some accounts this integration is set up automatically with a server-managed configuration. If your card already says **Connected** and mentions the server configuration, there's nothing for you to do. ### Adding tracking links to replies The order data is available to the agent, but it won't appear in a reply unless you tell the agent to use it. To do that, mention it in the Conversation Prompt using variables — placeholders wrapped in double curly braces that get replaced with the real value of each order. For example, add this to the prompt: > When the customer asks about shipping or delivery, include this tracking link: These are the available variables: | Variable | What it's replaced with | | ---------------------------------- | ----------------------- | | The Amazon order number | | | | The order status | | The marketplace or country of sale | | | The destination country | | | The shipping country | | | The tracking number | | | The tracking link | | | The carrier | | | The shipping service | | > **Note:** For the tracking link to fill in, the integration must be connected, the email thread must contain a recognisable Amazon order number, and the order must already have been shipped — tracking data only exists once Amazon generates it. More tools are expected to arrive in this section as AI Email Manager grows out of Beta. ## How to check it worked Three quick signs that everything is in place: 1. In the **Mail Agents** list, your agent no longer shows **No email assigned** underneath its name. 2. Send a test email to the connected inbox from a different address of your own, using wording that matches one of your categories. 3. Wait a few minutes and open the **Email** section. Depending on how you set up that category, you should find either a draft ready to review or a reply already sent. If nothing happens, check three things in order: that the inbox really is connected, that **Reply only to a specific sender** isn't switched on and pointing at a different address from the one you tested with, and that your test email actually matches a category description — an automatic reply only goes out when the message is classified into a category that has auto-reply enabled. ## What to do next * Write a couple more categories now that you've seen the agent in action. Real emails always suggest labels you hadn't thought of. * Visit the **Email** section every day during the first week to review your agent's drafts and polish the Conversation Prompt with what you learn. * Take a look at **Tools** from time to time: new integrations can appear as the product grows. # Create agent Source: https://support.callin.io/api-reference/agents/create-agent /openapi.json post /public/v1/agents/create Creates a new AI voice agent. The name, voice_id, primary_language, prompt, and llm fields are required. All other fields are optional and fall back to sensible defaults. # Get agent Source: https://support.callin.io/api-reference/agents/get-agent /openapi.json get /public/v1/agents/{agentId} Returns the full configuration and metadata for a single agent by its ID. # List agents Source: https://support.callin.io/api-reference/agents/list-agents /openapi.json get /public/v1/agents Returns a paginated list of AI voice agents in your account. Use search to filter by name, sortBy and sortDirection to control ordering, and cursor and pageSize to page through results. # Update agent Source: https://support.callin.io/api-reference/agents/update-agent /openapi.json patch /public/v1/agents/{agentId} Partially updates an agent. Only fields included in the request body are changed; omitted fields remain unchanged. Returns the full updated agent on success. # Get call recording Source: https://support.callin.io/api-reference/conversations/get-call-recording /openapi.json get /public/v1/conversations/{conversationId}/audio Returns the audio recording for a conversation. Only available when call recording is enabled on the agent. # Get conversation Source: https://support.callin.io/api-reference/conversations/get-conversation /openapi.json get /public/v1/conversations/{conversationId} Returns full details for a single conversation including the transcript, sentiment analysis, key moments, collected data, and call metadata. # List conversations Source: https://support.callin.io/api-reference/conversations/list-conversations /openapi.json get /public/v1/conversations Returns a paginated list of call conversations. Filter by agent, status, date range, or minimum call duration. Use cursor and pageSize to page through large result sets. # Health check Source: https://support.callin.io/api-reference/health/health-check /openapi.json get /public/health Returns 200 OK when the service is running. No authentication required. Use this to verify connectivity or monitor uptime. # Get current identity Source: https://support.callin.io/api-reference/identity/get-current-identity /openapi.json get /public/v1/me Returns the userId and email associated with the API key in the request. Useful for confirming which account a key belongs to. # Introduction Source: https://support.callin.io/api-reference/introduction Build, manage, and monitor AI voice agents using the Callin public API The Callin API lets you programmatically integrate AI voice agents into your product. Use it to create and configure agents, manage their knowledge bases, trigger calls, and retrieve call logs and transcripts — all over a simple REST interface. **Base URL** ``` https://api.callin.io/api ``` All endpoints are rooted under `/public`, for example: ``` https://api.callin.io/api/public/v1/agents ``` ## Authentication All endpoints (except the health check) require an API key. You can find yours in **Profile → API Key** on the Callin dashboard. Pass it in either of these ways: **Header** ```http theme={null} x-api-key:L'elenco degli agenti email. Ogni agente mostra il nome, la data di creazione e un avviso in arancione finché non ha nessuna casella collegata.
Si apre una breve procedura guidata che ti accompagna attraverso le stesse impostazioni descritte nei prossimi passi di questa guida: nome, istruzioni, categorie, regole di automazione e casella. Non preoccuparti di fare tutto perfetto al primo colpo: tutti i passaggi tranne il nome si possono saltare, e in seguito puoi modificare qualsiasi cosa dalle schede di configurazione dell'agente. Dagli un nome che ti dica a colpo d'occhio di cosa si occupa, ad esempio "Assistenza clienti" o "Casella vendite". Hai fino a 50 caratteri, e questo nome compare ovunque compaia l'agente, quindi meglio chiaro che ingegnoso. Puoi cambiarlo quando vuoi dal campo di testo nella parte superiore della schermata dell'agente. Sotto il nome, nell'elenco, vedrai **Nessuna email assegnata** in arancione. È normale: significa solo che non c'è ancora nessuna casella collegata. Lo risolverai al passo 4. Ogni riga dell'elenco ha inoltre un menu **⋮** con tre azioni: **Copia ID** copia l'identificativo unico dell'agente, **Modifica** apre la sua configurazione ed **Elimina** cancella l'agente in modo permanente dopo una conferma. Eliminare un agente cancella solo la sua configurazione e il suo collegamento: il tuo account di posta e i messaggi che contiene non vengono toccati. Una volta creato l'agente, la sua configurazione si organizza in quattro schede: **Agente**, **Categorie**, **Casella di posta** e **Avanzate**. I prossimi passi le percorrono in questo ordine. ## Passo 2 — Spiega all'agente come comportarsi Apri la scheda **Agente**. Qui definisci la personalità e il criterio dell'agente. ### Prompt di conversazione Il **prompt di conversazione** è un riquadro in cui scrivi, in linguaggio normale, come l'agente deve gestire la posta. Non c'è nessuna sintassi speciale: lo scrivi come spiegheresti il lavoro a un collega nuovo il suo primo giorno. Un esempio breve: > Rispondi in modo professionale e inoltra le domande sulla fatturazione a una persona. Più sei preciso, più il risultato sarà prevedibile. Una versione più utile per uno studio dentistico sarebbe: "Rispondi a nome dello Studio Dentistico Demo. Sii cordiale e breve. Rispondi alle domande su orari, indirizzo e prezzi. Se qualcuno chiede di spostare un appuntamento, digli che oggi stesso gli scriverà una persona del team e non promettere un orario preciso". Il contatore nell'angolo in basso a destra del riquadro ti indica quanto spazio hai usato dei 4000 caratteri disponibili. È più che sufficiente per istruzioni molto dettagliate. Qualsiasi modifica salvata qui si applica subito alla nuova posta in arrivo. > **Suggerimento:** Scrivi anche ciò che l'agente **non** deve fare, non solo ciò che deve fare. Frasi come "non confermare mai appuntamenti", "non promettere mai rimborsi" o "non parlare mai di prezzi via email" ti evitano quasi tutte le sorprese. ### Intelligenza IA (LLM) Sulla destra della stessa scheda vedrai **Intelligenza IA (LLM)**. Un **LLM** (modello linguistico di grandi dimensioni) è il motore che legge e scrive testo: è la parte che davvero capisce l'email e redige la risposta. Fai clic sulla scheda del modello per aprire un pannello laterale con le opzioni disponibili. Accanto a ogni modello vedrai un'etichetta che indica il suo livello di ragionamento, cioè quanto il modello "pensa" prima di scrivere. Più ragionamento porta più sfumature, ma anche più tempo e più costo per risposta. | Modello | Livello di ragionamento | Per cosa va bene | | ------------- | ----------------------- | --------------------------------------------------------------------- | | GPT 5.4 Mini | Basso | L'opzione predefinita, equilibrata tra qualità, velocità e costo | | Claude Sonnet | Medio | Risposte in cui il tono conta di più, con una voce curata e naturale | | GPT 5.4 Nano | Basso | Grandi volumi di posta semplice, dove contano di più velocità e costo | | GPT 4.1 Mini | Basso | Un'opzione stabile ed equilibrata per un traffico alto e costante | Nello stesso pannello trovi la **temperatura**, un cursore da 0 a 1 che parte da 0,7. Regola quanto le risposte dell'agente sono creative o prevedibili. I valori bassi mantengono una scrittura costante e ripetibile, utile quando le risposte devono seguire un modello. I valori alti rendono la scrittura più varia e naturale, in cambio di più differenze tra messaggi simili. > **Se è la prima volta:** Non devi toccare niente di tutto questo. Il modello e la temperatura predefiniti funzionano bene per la maggior parte delle caselle. Torna più avanti: se le risposte suonano robotiche, prova Claude Sonnet o alza un po' la temperatura; se variano troppo, abbassala. ## Passo 3 — Organizza la tua posta con le categorie Apri la scheda **Categorie**. Le categorie sono etichette facoltative che aiutano l'agente a capire con che tipo di messaggio ha a che fare: fatture, reclami, richieste di appuntamento, ecc. Ogni categoria esistente compare come una scheda con la sua etichetta, la sua descrizione e un'icona a matita per modificarla o a cestino per eliminarla. Vale la pena configurarle perché ti permettono di trattare ogni tipo di posta in modo diverso. Magari vuoi che l'agente risponda da solo a una domanda semplice sugli orari, ma che si limiti a preparare una bozza quando il messaggio parla di soldi. Fai clic su **Aggiungi categoria**. Si apre una finestra con questi campi: | Campo | Cosa fa | Esempio | | --------------------- | ----------------------------------------------------------- | ---------------------------- | | Nome della categoria | L'etichetta breve che vedrai su ogni email | Fatturazione | | Descrizione | Indica all'agente quando usare questa categoria | Fatture, pagamenti, rimborsi | | Colore dell'etichetta | Il colore dell'etichetta, per riconoscerla a colpo d'occhio | Rosa | Puoi scegliere uno dei colori predefiniti o crearne uno tuo con il campione **+**. Sotto ci sono due interruttori: * **Genera bozza di risposta per questa categoria**: attivo per impostazione predefinita. L'agente prepara la risposta e te la lascia pronta da rivedere prima che parta. * **Risposta automatica per questa categoria**: disattivo per impostazione predefinita. L'agente invia la risposta da solo, senza revisione. Se li disattivi entrambi, l'agente continua a etichettare il messaggio con la categoria ma non scrive nessuna risposta. È utile per la posta che vuoi sempre far gestire a una persona da zero, come reclami o questioni legali. > **Errore comune:** Scrivere una descrizione troppo vaga, tipo "cose importanti". L'agente usa quel testo per decidere quali email finiscono qui, quindi descrivi il contenuto reale: "messaggi che chiedono una fattura, un rimborso o un cambio di metodo di pagamento". Se vedi che le email finiscono nella categoria sbagliata, affinare la descrizione è di solito la soluzione più rapida. > **Importante:** Inizia con **Genera bozza di risposta** attivo e **Risposta automatica** disattivo. Leggi le bozze per qualche giorno. Quando avrai verificato che l'agente azzecca il tono e i dati, attiva la risposta automatica nelle categorie in cui un errore non avrebbe conseguenze. ## Passo 4 — Collega la casella Apri la scheda **Casella di posta**. Qui colleghi l'account di posta reale di cui si occuperà l'agente. Finché non lo fai, l'agente è configurato ma fermo. Hai tre opzioni: * **Gmail**: collega il tuo account Google. Approvi il collegamento nella consueta schermata di autorizzazione di Google, senza configurare nulla a mano. * **Outlook**: collega Microsoft 365, nello stesso modo di Gmail. * **Altra email (IMAP e SMTP)**: collega qualsiasi altro provider. **IMAP** è lo standard che permette all'agente di leggere la posta della tua casella, e **SMTP** è quello che gli permette di inviare le risposte. Il tuo provider pubblica entrambi i dati nelle sue pagine di assistenza. Se scegli l'opzione manuale, il modulo ti chiede: | Campo | Cosa inserire | | ---------------------------- | --------------------------------------------------------------------------------------------------- | | Indirizzo email | La casella da cui l'agente leggerà e da cui invierà | | Password | La tua password o, meglio, una password per le app se il tuo account ha la verifica in due passaggi | | Server IMAP | Il server di lettura, qualcosa come imap.tuoprovider.com | | Porta IMAP | Di solito 993, che il modulo suggerisce per impostazione predefinita | | Giorni di posta da importare | Quanto indietro guarda l'agente al primo collegamento, da 1 a 45 giorni | | Server SMTP | Il server di invio, qualcosa come smtp.tuoprovider.com | | Porta SMTP | Di solito 587, che il modulo suggerisce per impostazione predefinita | Sotto le opzioni, la schermata ti ricorda che le tue credenziali vengono salvate cifrate e in modo sicuro. > **Nota:** Puoi saltare questo passo e collegare la casella più tardi. Tutto ciò che hai configurato nei passi precedenti resta salvato. Ricorda però che l'agente non elaborerà assolutamente nulla finché non ci sarà una casella collegata. ## Passo 5 — Regola il comportamento (facoltativo) Apri la scheda **Avanzate**. Tutto ciò che c'è qui è facoltativo, ed entrambe le regole partono disattivate. Se questo è il tuo primo agente, puoi saltare tranquillamente al passo 6 e tornare un altro giorno. ### Regole di automazione **Rispondi solo a un mittente specifico.** Quando lo attivi e scrivi un indirizzo in **Indirizzo email del mittente**, l'agente elabora e risponde solo ai messaggi che arrivano da quell'indirizzo. Tutti gli altri mittenti vengono ignorati del tutto, e le categorie diventano facoltative. È perfetto per automazioni ristrette e con un unico scopo — rispondere sempre a un sistema automatico o a un contatto specifico — ed è anche il modo più sicuro per provare un agente in una casella reale: puntalo sul tuo indirizzo e osserva cosa fa, senza toccare nessun cliente. **Copia le risposte automatiche.** Invia una copia di ogni risposta automatica a un indirizzo aggiuntivo, che scrivi in **Email del destinatario in copia**. In **Tipo di invio** scegli come viaggia quella copia: * **CC (visibile)**: la persona che riceve la risposta vede quell'indirizzo nella riga di copia. * **CCN (nascosta)**: la copia viene inviata in silenzio e il destinatario non vede nulla. È utile quando un responsabile vuole seguire da vicino ciò che l'agente invia. > **Suggerimento:** Se attivi la risposta automatica in qualche categoria, attiva anche la copia, almeno finché non avrai preso fiducia in ciò che scrive l'agente. > **Attenzione:** Se la copia va a un collega interno, scegli **CCN (nascosta)**. Con **CC (visibile)**, il tuo cliente vede l'email del tuo collega in ogni messaggio. ### Priorità degli agenti Quando più agenti condividono la stessa casella, il primo agente che corrisponde a un'email è quello che se ne occupa: il messaggio non passa agli altri. Questa sezione ti permette di riordinare gli agenti con le frecce su e giù. Ordinali dal più specifico al più generale: un agente limitato a un solo mittente dovrebbe stare sopra un agente generico di assistenza, così l'agente pigliatutto non si prende tutti i messaggi. Potrai cambiare l'ordine solo quando ci sarà una casella collegata. Fino ad allora, la schermata ti indica di collegarne una nella scheda **Casella di posta**. ## Passo 6 — Salva le modifiche Quando hai modifiche non salvate compare una barra nella parte inferiore dello schermo con due pulsanti: **Annulla**, che cancella tutto ciò che hai appena cambiato, e **Salva**, che lo memorizza. > **Importante:** Non uscire dalla schermata mentre quella barra è visibile. Se te ne vai senza fare clic su **Salva**, perdi le modifiche. ## La sezione Email: leggi e rispondi in un unico posto Apri **Email** nella barra laterale sinistra. Questa è la casella unificata: qui compaiono i messaggi elaborati dai tuoi agenti, da tutte le caselle collegate, con la categoria ricevuta da ciascuno. È anche il posto dove rivedi, modifichi e invii le bozze preparate dai tuoi agenti. Se non hai ancora collegato nessuna casella, la schermata ti spiega esattamente cosa manca e come risolverlo in tre passi: apri **Agenti email** e seleziona un agente, collega la casella nella scheda **Casella di posta** con Google, con Microsoft o tramite IMAP, e torna qui per leggere e rispondere ai messaggi. I due pulsanti di quella schermata, **Vai ad Agenti email** e **Crea agente email**, ti portano direttamente lì.La sezione Email prima di collegare qualsiasi casella. La schermata stessa ti guida attraverso i tre passi che mancano.
Quando ci sarà una casella collegata, i messaggi in arrivo compariranno qui pochi minuti dopo l'arrivo, insieme alle bozze e alle risposte preparate dal tuo agente. ## La sezione Strumenti: dai superpoteri ai tuoi agenti Apri **Strumenti** nella barra laterale sinistra. Qui colleghi servizi esterni che ampliano ciò che i tuoi agenti possono fare con ogni email, dando loro accesso a dati in tempo reale che non si trovano nella conversazione stessa. ### Amazon Seller API Con questa integrazione collegata, quando l'email di un cliente contiene un numero d'ordine Amazon, l'agente consulta automaticamente i dettagli dell'ordine e può usarli nella sua risposta, invece di chiedere al cliente informazioni che il sistema ha già.La sezione Strumenti con l'integrazione Amazon Seller API collegata. La scheda mostra i dati dell'account e lo stato della connessione.
Quando l'integrazione è attiva, la sua scheda mostra un badge verde **Collegato** insieme ai dettagli della connessione: il nome dell'account venditore, l'identificativo del partner di vendita, la regione, il mercato e la data del collegamento. Dalla stessa scheda puoi scrivere un numero d'ordine reale in **ID ordine di prova** e premere **Prova connessione** per verificare che tutto funzioni senza aspettare l'email di un cliente, oppure usare **Disconnetti** per scollegarla. In alcuni account questa integrazione si configura automaticamente con una configurazione gestita dal server. Se la tua scheda dice già **Collegato** e menziona la configurazione del server, non devi fare nulla. ### Aggiungere link di tracciamento alle risposte I dati dell'ordine sono a disposizione dell'agente, ma non compariranno in una risposta se non gli dici di usarli. Per farlo, menzionali nel prompt di conversazione usando le variabili: segnaposto tra doppie parentesi graffe che vengono sostituiti dal valore reale di ogni ordine. Ad esempio, aggiungi questo al prompt: > Quando il cliente chiede della spedizione o della consegna, includi questo link di tracciamento: Queste sono le variabili disponibili: | Variabile | Con cosa viene sostituita | | ----------------------------- | ------------------------- | | Il numero d'ordine Amazon | | | | Lo stato dell'ordine | | Il mercato o paese di vendita | | | Il paese di destinazione | | | Il paese di spedizione | | | Il numero di tracciamento | | | Il link di tracciamento | | | Il corriere | | | Il servizio di spedizione | | > **Nota:** Perché il link di tracciamento si compili, l'integrazione deve essere collegata, la conversazione email deve contenere un numero d'ordine Amazon riconoscibile e l'ordine deve essere già stato spedito: i dati di tracciamento esistono solo quando Amazon li genera. Ci si aspetta che arrivino altri strumenti in questa sezione man mano che il Gestore Email con IA uscirà dalla fase Beta. ## Come verificare che funziona Tre segnali rapidi che tutto è al suo posto: 1. Nell'elenco **Agenti email**, il tuo agente non mostra più **Nessuna email assegnata** sotto il nome. 2. Invia un'email di prova alla casella collegata da un altro tuo indirizzo, con un testo che corrisponda a una delle tue categorie. 3. Aspetta qualche minuto e apri la sezione **Email**. A seconda di come hai configurato quella categoria, dovresti trovare una bozza pronta da rivedere o una risposta già inviata. Se non succede nulla, verifica tre cose in ordine: che la casella sia davvero collegata, che non sia attivo **Rispondi solo a un mittente specifico** puntato su un indirizzo diverso da quello usato nella prova, e che la tua email di prova corrisponda davvero alla descrizione di una categoria: la risposta automatica parte solo quando il messaggio viene classificato in una categoria con la risposta automatica attiva. ## Cosa fare dopo * Crea un paio di categorie in più ora che hai visto l'agente in azione. Le email reali suggeriscono sempre etichette a cui non avevi pensato. * Visita la sezione **Email** ogni giorno durante la prima settimana per rivedere le bozze del tuo agente e affinare il prompt di conversazione con ciò che impari. * Dai un'occhiata a **Strumenti** ogni tanto: possono comparire nuove integrazioni man mano che il prodotto cresce. # E-Mail-Manager mit AI Source: https://support.callin.io/untitled-page Agenten, E-Mail und Werkzeuge: Entdecke den Bereich E-Mail-Manager mit KI von Callin.io und richte Schritt für Schritt einen Agenten ein, der deine E-Mails liest, sortiert und beantwortet. Der **E-Mail-Manager mit KI** ist der Bereich von Callin.io, in dem deine KI aufhört zu telefonieren und anfängt, sich um deine E-Mails zu kümmern. Er gliedert sich in drei Bereiche, die du in der linken Seitenleiste findest: * **E-Mail-Agenten**: Hier erstellst und konfigurierst du die Agenten, die deine E-Mails verwalten. * **E-Mail**: Hier liest und beantwortest du die Nachrichten, die deine Agenten verarbeitet haben. * **Werkzeuge**: Hier verbindest du externe Dienste, die deinen Agenten zusätzliche Fähigkeiten geben. Ein **E-Mail-Agent** ist ein Assistent, der ein Postfach für dich im Auge behält. Er liest jede neue Nachricht, versteht, worum es geht, und bereitet eine Antwort nach den Anweisungen vor, die du ihm gibst. Du entscheidest, wie weit er geht: Er kann dir einen Entwurf zur Prüfung hinterlassen oder die Antwort selbstständig versenden. Jeder Agent ist mit jeweils einem Postfach verbunden, aber mehrere Agenten können sich dasselbe Postfach teilen und die Arbeit untereinander aufteilen. Dieser Leitfaden geht die drei Bereiche der Reihe nach durch. Deinen ersten Agenten einzurichten dauert etwa zehn Minuten, und du brauchst keinerlei technisches Vorwissen. > **Hinweis:** Der E-Mail-Manager mit KI ist als **Beta** gekennzeichnet. Das bedeutet, dass er noch wächst, sodass manche Bildschirme in deinem Konto etwas anders aussehen können. ## Was du vor dem Start brauchst * Das E-Mail-Konto, mit dem der Agent arbeiten soll. Das kann Gmail, Outlook oder fast jeder andere Anbieter sein. * Falls dieses Konto die Zwei-Faktor-Authentifizierung nutzt und du weder Gmail noch Outlook verwendest, ein **App-Passwort**: ein spezielles Passwort, das dein Anbieter zum Verbinden externer Anwendungen erzeugt, damit du dein echtes Passwort nie weitergibst. * Eine ungefähre Vorstellung davon, was der Agent tun soll. Ein Satz reicht fürs Erste, zum Beispiel: „Er soll Fragen zu den Öffnungszeiten beantworten und alles rund um Rechnungen an einen Menschen weitergeben." Das Postfach muss jetzt noch nicht bereit sein. Du kannst zuerst den Agenten erstellen und das Postfach später verbinden. ## Schritt 1 — Erstelle den Agenten Öffne in der linken Seitenleiste **E-Mail-Agenten**. Dort findest du die Liste aller Agenten, die du erstellt hast. Klicke oben rechts auf **Agent erstellen**.Die Liste der E-Mail-Agenten. Jeder Agent zeigt seinen Namen, sein Erstellungsdatum und einen orangefarbenen Hinweis, solange kein Postfach verbunden ist.
Es öffnet sich ein kurzer Einrichtungsassistent, der dich durch dieselben Einstellungen führt, die in den nächsten Schritten dieses Leitfadens beschrieben werden: Name, Anweisungen, Kategorien, Automatisierungsregeln und Postfach. Mach dir keine Sorgen, alles beim ersten Mal perfekt zu machen: Alle Schritte außer dem Namen lassen sich überspringen, und später kannst du alles über die Konfigurationsreiter des Agenten ändern. Gib ihm einen Namen, der dir auf einen Blick sagt, worum er sich kümmert, zum Beispiel „Kundenservice" oder „Vertriebspostfach". Du hast bis zu 50 Zeichen, und dieser Name erscheint überall dort, wo der Agent erscheint — also lieber klar als originell. Du kannst ihn jederzeit über das Textfeld oben auf dem Bildschirm des Agenten ändern. Unter dem Namen siehst du in der Liste **Keine E-Mail zugewiesen** in Orange. Das ist normal: Es bedeutet nur, dass noch kein Postfach verbunden ist. Das löst du in Schritt 4. Jede Zeile der Liste hat außerdem ein **⋮**-Menü mit drei Aktionen: **ID kopieren** kopiert die eindeutige Kennung des Agenten, **Bearbeiten** öffnet seine Konfiguration und **Löschen** entfernt den Agenten nach einer Bestätigung dauerhaft. Beim Löschen eines Agenten werden nur seine Konfiguration und seine Verbindung entfernt: Dein E-Mail-Konto und die darin enthaltenen Nachrichten bleiben unberührt. Sobald der Agent existiert, gliedert sich seine Konfiguration in vier Reiter: **Agent**, **Kategorien**, **Postfach** und **Erweitert**. Die nächsten Schritte gehen sie in dieser Reihenfolge durch. ## Schritt 2 — Erkläre dem Agenten, wie er sich verhalten soll Öffne den Reiter **Agent**. Hier legst du die Persönlichkeit und das Urteilsvermögen des Agenten fest. ### Konversations-Prompt Der **Konversations-Prompt** ist ein Feld, in dem du in normaler Sprache aufschreibst, wie der Agent mit E-Mails umgehen soll. Es gibt keine besondere Syntax: Du schreibst es so, wie du einem neuen Kollegen an seinem ersten Tag die Arbeit erklären würdest. Ein kurzes Beispiel: > Antworte professionell und leite Fragen zur Abrechnung an einen Menschen weiter. Je präziser du bist, desto vorhersehbarer wird das Ergebnis. Eine nützlichere Version für eine Zahnarztpraxis wäre: „Du antwortest im Namen der Demo-Zahnarztpraxis. Sei freundlich und knapp. Beantworte Fragen zu Öffnungszeiten, Adresse und Preisen. Wenn jemand einen Termin verschieben möchte, sag ihm, dass sich noch heute jemand aus dem Team meldet, und versprich keine konkrete Uhrzeit." Der Zähler in der unteren rechten Ecke des Feldes zeigt dir, wie viel Platz du von den 4000 verfügbaren Zeichen verbraucht hast. Das ist mehr als genug für sehr detaillierte Anweisungen. Jede Änderung, die du hier speicherst, gilt sofort für neu eingehende E-Mails. > **Tipp:** Schreib auch auf, was der Agent **nicht** tun darf, nicht nur, was er tun soll. Sätze wie „bestätige niemals Termine", „versprich niemals Rückerstattungen" oder „sprich niemals per E-Mail über Preise" ersparen dir fast alle Überraschungen. ### KI-Intelligenz (LLM) Auf der rechten Seite desselben Reiters siehst du **KI-Intelligenz (LLM)**. Ein **LLM** (großes Sprachmodell) ist der Motor, der Text liest und schreibt: Es ist der Teil, der die E-Mail wirklich versteht und die Antwort verfasst. Klicke auf die Modellkarte, um ein Seitenpanel mit den verfügbaren Optionen zu öffnen. Neben jedem Modell siehst du eine Kennzeichnung, die sein Denkniveau angibt, also wie viel das Modell „nachdenkt", bevor es schreibt. Mehr Nachdenken bringt mehr Feingefühl, aber auch mehr Zeit und höhere Kosten pro Antwort. | Modell | Denkniveau | Wofür es sich eignet | | ------------- | ---------- | ----------------------------------------------------------------------------------------- | | GPT 5.4 Mini | Niedrig | Die Standardoption, ausgewogen bei Qualität, Geschwindigkeit und Kosten | | Claude Sonnet | Mittel | Antworten, bei denen der Ton am wichtigsten ist, mit einer gepflegten, natürlichen Stimme | | GPT 5.4 Nano | Niedrig | Große Mengen einfacher E-Mails, bei denen Geschwindigkeit und Kosten mehr zählen | | GPT 4.1 Mini | Niedrig | Eine stabile, ausgewogene Option für hohen, gleichmäßigen Verkehr | Im selben Panel findest du die **Temperatur**, einen Schieberegler von 0 bis 1, der bei 0,7 startet. Sie regelt, wie kreativ oder vorhersehbar die Antworten des Agenten sind. Niedrige Werte sorgen für eine gleichbleibende, wiederholbare Formulierung — nützlich, wenn Antworten einer Vorlage folgen sollen. Hohe Werte machen die Formulierung abwechslungsreicher und natürlicher, im Tausch gegen mehr Unterschiede zwischen ähnlichen Nachrichten. > **Wenn du neu bist:** Du musst hier nichts anfassen. Das Standardmodell und die Standardtemperatur funktionieren für die meisten Postfächer gut. Komm später wieder: Wenn die Antworten roboterhaft klingen, probiere Claude Sonnet oder erhöhe die Temperatur ein wenig; wenn sie zu stark variieren, senke sie. ## Schritt 3 — Organisiere deine E-Mails mit Kategorien Öffne den Reiter **Kategorien**. Kategorien sind optionale Etiketten, die dem Agenten helfen zu verstehen, mit welcher Art von Nachricht er es zu tun hat: Rechnungen, Beschwerden, Terminanfragen usw. Jede vorhandene Kategorie erscheint als Karte mit ihrem Etikett, ihrer Beschreibung und einem Stift-Symbol zum Bearbeiten oder einem Papierkorb-Symbol zum Löschen. Es lohnt sich, sie einzurichten, weil du damit jede Art von E-Mail unterschiedlich behandeln kannst. Vielleicht soll der Agent eine einfache Frage zu den Öffnungszeiten selbstständig beantworten, aber nur einen Entwurf vorbereiten, wenn es in der Nachricht um Geld geht. Klicke auf **Kategorie hinzufügen**. Es öffnet sich ein Fenster mit diesen Feldern: | Feld | Was es tut | Beispiel | | ------------------ | --------------------------------------------------------- | --------------------------------------- | | Name der Kategorie | Das kurze Etikett, das du auf jeder E-Mail siehst | Abrechnung | | Beschreibung | Sagt dem Agenten, wann er diese Kategorie verwenden soll | Rechnungen, Zahlungen, Rückerstattungen | | Farbe des Etiketts | Die Farbe des Etiketts, um es auf einen Blick zu erkennen | Rosa | Du kannst eine der vordefinierten Farben wählen oder mit dem **+**-Feld eine eigene erstellen. Darunter gibt es zwei Schalter: * **Antwortentwurf für diese Kategorie erstellen**: standardmäßig aktiviert. Der Agent bereitet die Antwort vor und legt sie dir zur Prüfung bereit, bevor sie rausgeht. * **Automatische Antwort für diese Kategorie**: standardmäßig deaktiviert. Der Agent versendet die Antwort selbst, ohne Prüfung. Wenn du beide deaktivierst, versieht der Agent die Nachricht weiterhin mit der Kategorie, schreibt aber keine Antwort. Das ist nützlich für E-Mails, die immer ein Mensch von Grund auf bearbeiten soll, wie Beschwerden oder rechtliche Angelegenheiten. > **Häufiger Fehler:** Eine zu vage Beschreibung schreiben, etwa „wichtige Sachen". Der Agent nutzt diesen Text, um zu entscheiden, welche E-Mails hier landen — beschreibe also den tatsächlichen Inhalt: „Nachrichten, die eine Rechnung, eine Rückerstattung oder eine Änderung der Zahlungsmethode anfragen". Wenn E-Mails in der falschen Kategorie landen, ist das Schärfen der Beschreibung meist die schnellste Lösung. > **Wichtig:** Beginne mit aktiviertem **Antwortentwurf erstellen** und deaktivierter **Automatischer Antwort**. Lies die Entwürfe ein paar Tage lang. Sobald du geprüft hast, dass der Agent Ton und Fakten trifft, aktiviere die automatische Antwort in den Kategorien, in denen ein Fehler keine Folgen hätte. ## Schritt 4 — Verbinde das Postfach Öffne den Reiter **Postfach**. Hier verknüpfst du das echte E-Mail-Konto, um das sich der Agent kümmern wird. Bis dahin ist der Agent zwar konfiguriert, aber untätig. Du hast drei Möglichkeiten: * **Gmail**: Verbinde dein Google-Konto. Du bestätigst die Verbindung auf dem gewohnten Berechtigungsbildschirm von Google, ohne etwas von Hand zu konfigurieren. * **Outlook**: Verbinde Microsoft 365, auf dieselbe Weise wie Gmail. * **Andere E-Mail (IMAP und SMTP)**: Verbinde jeden anderen Anbieter. **IMAP** ist der Standard, mit dem der Agent die E-Mails deines Postfachs lesen kann, und **SMTP** ist derjenige, mit dem er die Antworten versenden kann. Dein Anbieter veröffentlicht beide Angaben auf seinen Hilfeseiten. Wenn du die manuelle Option wählst, fragt das Formular Folgendes ab: | Feld | Was einzutragen ist | | ---------------------------- | ------------------------------------------------------------------------------------------------------ | | E-Mail-Adresse | Das Postfach, aus dem der Agent liest und von dem er sendet | | Passwort | Dein Passwort oder, besser, ein App-Passwort, falls dein Konto die Zwei-Faktor-Authentifizierung nutzt | | IMAP-Server | Der Leseserver, etwa imap.deinanbieter.com | | IMAP-Port | Normalerweise 993, den das Formular standardmäßig vorschlägt | | Zu importierende E-Mail-Tage | Wie weit der Agent bei der ersten Verbindung zurückblickt, von 1 bis 45 Tagen | | SMTP-Server | Der Versandserver, etwa smtp.deinanbieter.com | | SMTP-Port | Normalerweise 587, den das Formular standardmäßig vorschlägt | Unter den Optionen erinnert dich der Bildschirm daran, dass deine Zugangsdaten verschlüsselt und sicher gespeichert werden. > **Hinweis:** Du kannst diesen Schritt überspringen und das Postfach später verbinden. Alles, was du in den vorherigen Schritten konfiguriert hast, bleibt gespeichert. Denk aber daran, dass der Agent absolut nichts verarbeitet, solange kein Postfach verknüpft ist. ## Schritt 5 — Feinjustiere das Verhalten (optional) Öffne den Reiter **Erweitert**. Alles hier ist optional, und beide Regeln starten deaktiviert. Wenn dies dein erster Agent ist, kannst du problemlos zu Schritt 6 springen und an einem anderen Tag zurückkommen. ### Automatisierungsregeln **Nur einem bestimmten Absender antworten.** Wenn du das aktivierst und eine Adresse in **E-Mail-Adresse des Absenders** einträgst, verarbeitet und beantwortet der Agent nur Nachrichten, die von dieser Adresse kommen. Alle anderen Absender werden vollständig ignoriert, und die Kategorien werden optional. Das ist perfekt für eng gefasste Automatisierungen mit einem einzigen Zweck — immer einem automatischen System oder einem bestimmten Kontakt antworten — und es ist auch der sicherste Weg, einen Agenten in einem echten Postfach zu testen: Richte ihn auf deine eigene Adresse und beobachte, was er tut, ohne einen einzigen Kunden zu berühren. **Automatische Antworten kopieren.** Sendet eine Kopie jeder automatischen Antwort an eine zusätzliche Adresse, die du in **E-Mail des Kopie-Empfängers** einträgst. Unter **Versandart** wählst du, wie diese Kopie unterwegs ist: * **CC (sichtbar)**: Die Person, die die Antwort erhält, sieht diese Adresse in der Kopiezeile. * **BCC (verborgen)**: Die Kopie wird still versendet, und der Empfänger sieht nichts. Das ist praktisch, wenn eine verantwortliche Person im Blick behalten möchte, was der Agent versendet. > **Tipp:** Wenn du in einer Kategorie die automatische Antwort aktivierst, aktiviere auch die Kopie — zumindest solange du noch Vertrauen in das aufbaust, was der Agent schreibt. > **Warnung:** Wenn die Kopie an einen internen Kollegen geht, wähle **BCC (verborgen)**. Mit **CC (sichtbar)** sieht dein Kunde die E-Mail-Adresse deines Kollegen in jeder Nachricht. ### Agenten-Priorität Wenn sich mehrere Agenten dasselbe Postfach teilen, kümmert sich der erste Agent, der zu einer E-Mail passt, um sie: Die Nachricht geht nicht an die anderen weiter. In diesem Abschnitt kannst du die Agenten mit Auf- und Ab-Pfeilen neu ordnen. Ordne sie vom spezifischsten zum allgemeinsten: Ein auf einen einzigen Absender beschränkter Agent sollte über einem allgemeinen Support-Agenten stehen, damit der Allzweck-Agent nicht alle Nachrichten an sich reißt. Die Reihenfolge kannst du erst ändern, wenn ein Postfach verbunden ist. Bis dahin weist dich der Bildschirm darauf hin, eines im Reiter **Postfach** zu verbinden. ## Schritt 6 — Speichere deine Änderungen Wenn du ungespeicherte Änderungen hast, erscheint am unteren Bildschirmrand eine Leiste mit zwei Schaltflächen: **Verwerfen**, das alles rückgängig macht, was du gerade geändert hast, und **Speichern**, das es sichert. > **Wichtig:** Verlasse den Bildschirm nicht, solange diese Leiste sichtbar ist. Wenn du gehst, ohne auf **Speichern** zu klicken, verlierst du deine Änderungen. ## Der Bereich E-Mail: Lesen und Antworten an einem Ort Öffne **E-Mail** in der linken Seitenleiste. Das ist das vereinheitlichte Postfach: Hier erscheinen die von deinen Agenten verarbeiteten Nachrichten aus allen verbundenen Postfächern, mit der Kategorie, die jede erhalten hat. Hier prüfst, bearbeitest und versendest du auch die Entwürfe, die deine Agenten vorbereitet haben. Wenn du noch kein Postfach verbunden hast, erklärt dir der Bildschirm genau, was fehlt und wie du es in drei Schritten löst: Öffne **E-Mail-Agenten** und wähle einen Agenten aus, verbinde das Postfach im Reiter **Postfach** mit Google, mit Microsoft oder über IMAP, und komm hierher zurück, um die Nachrichten zu lesen und zu beantworten. Die beiden Schaltflächen auf diesem Bildschirm, **Zu E-Mail-Agenten gehen** und **E-Mail-Agent erstellen**, bringen dich direkt dorthin.Der Bereich E-Mail, bevor irgendein Postfach verbunden ist. Der Bildschirm selbst führt dich durch die drei fehlenden Schritte.
Sobald ein Postfach verbunden ist, erscheinen eingehende Nachrichten hier wenige Minuten nach ihrem Eintreffen, zusammen mit den Entwürfen und Antworten, die dein Agent vorbereitet hat. ## Der Bereich Werkzeuge: Gib deinen Agenten Superkräfte Öffne **Werkzeuge** in der linken Seitenleiste. Hier verbindest du externe Dienste, die erweitern, was deine Agenten mit jeder E-Mail tun können, indem sie ihnen Zugriff auf Live-Daten geben, die nicht in der Konversation selbst stehen. ### Amazon Seller API Mit dieser verbundenen Integration schlägt der Agent, wenn die E-Mail eines Kunden eine Amazon-Bestellnummer enthält, die Bestelldetails automatisch nach und kann sie in seiner Antwort verwenden, anstatt den Kunden nach Informationen zu fragen, die das System bereits hat.Der Bereich Werkzeuge mit verbundener Amazon Seller API Integration. Die Karte zeigt die Kontodaten und den Verbindungsstatus.
Wenn die Integration aktiv ist, zeigt ihre Karte ein grünes **Verbunden**-Abzeichen zusammen mit den Verbindungsdetails: dem Namen des Verkäuferkontos, der Kennung des Verkaufspartners, der Region, dem Marktplatz und dem Datum der Verbindung. Von derselben Karte aus kannst du eine echte Bestellnummer in **Test-Bestell-ID** eintragen und auf **Verbindung testen** drücken, um zu prüfen, dass alles funktioniert, ohne auf die E-Mail eines Kunden zu warten, oder **Trennen** verwenden, um die Verknüpfung aufzuheben. In manchen Konten wird diese Integration automatisch mit einer vom Server verwalteten Konfiguration eingerichtet. Wenn deine Karte bereits **Verbunden** anzeigt und die Serverkonfiguration erwähnt, musst du nichts tun. ### Sendungsverfolgungs-Links zu Antworten hinzufügen Die Bestelldaten stehen dem Agenten zur Verfügung, aber sie erscheinen nicht in einer Antwort, wenn du ihm nicht sagst, dass er sie nutzen soll. Erwähne sie dafür im Konversations-Prompt mithilfe von Variablen: Platzhalter in doppelten geschweiften Klammern, die durch den echten Wert jeder Bestellung ersetzt werden. Füge dem Prompt zum Beispiel Folgendes hinzu: > Wenn der Kunde nach dem Versand oder der Lieferung fragt, füge diesen Sendungsverfolgungs-Link ein: Das sind die verfügbaren Variablen: | Variable | Wodurch sie ersetzt wird | | ------------------------------------ | ------------------------ | | Die Amazon-Bestellnummer | | | Der Bestellstatus | | | Der Marktplatz oder das Verkaufsland | | | Das Zielland | | | Das Versandland | | | Die Sendungsnummer | | | Der Sendungsverfolgungs-Link | | | Der Zusteller | | | Der Versanddienst | | > **Hinweis:** Damit sich der Sendungsverfolgungs-Link füllt, muss die Integration verbunden sein, die E-Mail-Konversation muss eine erkennbare Amazon-Bestellnummer enthalten, und die Bestellung muss bereits versendet worden sein: Die Sendungsverfolgungsdaten existieren erst, wenn Amazon sie erzeugt. Es ist zu erwarten, dass in diesem Bereich weitere Werkzeuge hinzukommen, während der E-Mail-Manager mit KI die Beta-Phase verlässt. ## So prüfst du, ob es funktioniert Drei schnelle Zeichen, dass alles an seinem Platz ist: 1. In der Liste **E-Mail-Agenten** zeigt dein Agent unter seinem Namen nicht mehr **Keine E-Mail zugewiesen** an. 2. Sende eine Test-E-Mail von einer anderen deiner Adressen an das verbundene Postfach, mit einem Text, der zu einer deiner Kategorien passt. 3. Warte ein paar Minuten und öffne den Bereich **E-Mail**. Je nachdem, wie du diese Kategorie konfiguriert hast, solltest du einen prüfbereiten Entwurf oder eine bereits versendete Antwort finden. Wenn nichts passiert, prüfe drei Dinge der Reihe nach: dass das Postfach wirklich verbunden ist, dass **Nur einem bestimmten Absender antworten** nicht aktiviert ist und auf eine andere Adresse zeigt als die, die du im Test verwendet hast, und dass deine Test-E-Mail wirklich zur Beschreibung einer Kategorie passt: Die automatische Antwort geht nur raus, wenn die Nachricht in eine Kategorie mit aktivierter automatischer Antwort eingeordnet wird. ## Was du als Nächstes tun kannst * Erstelle ein paar weitere Kategorien, jetzt wo du den Agenten in Aktion gesehen hast. Echte E-Mails bringen dich immer auf Etiketten, an die du nicht gedacht hattest. * Besuche den Bereich **E-Mail** in der ersten Woche jeden Tag, um die Entwürfe deines Agenten zu prüfen und den Konversations-Prompt mit dem zu verfeinern, was du lernst. * Wirf ab und zu einen Blick auf die **Werkzeuge**: Neue Integrationen können hinzukommen, während das Produkt wächst.