VoIP.ms Wiki - New pages [en]

Reporte de Agentes de IA

2026-05-20T19:55:16Z

Johann Jimenez: Created page with "{| cellspacing="0" style="width: 100%; background: linear-gradient(135deg, #f8fafc 0%, #f1f5f9 100%); border: 1px solid #e2e8f0; border-radius: 8px; padding: 35px; margin-bottom:..."

AI Agent Report

2026-05-15T21:58:21Z

Johann Jimenez:

Agents IA

2026-04-25T00:46:53Z

Scomtois:

{| cellspacing="0" style="width: 100%; background: linear-gradient(135deg, #f8fafc 0%, #f1f5f9 100%); border: 1px solid #e2e8f0; border-radius: 8px; padding: 35px; margin-bottom: 25px; box-shadow: 0 1px 3px rgba(0,0,0,0.05);"
|-
| style="text-align: center;" |

<div style="font-size: 2.8em; font-weight: 200; color: #1e293b; margin-bottom: 15px; letter-spacing: -2px;">Agents IA (Bêta)</div>

<div style="font-size: 1rem; color: #64748b; margin-bottom: 15px;">
Configurez un agent vocal pour mieux gérer vos appels entrants.
</div>

<div style="font-size: 0.9rem; color: #94a3b8;">
'''[https://wiki.voip.ms/article/AI_agents 🇺🇸 English]'''  •  '''[https://wiki.voip.ms/ 🇲🇽 Español (Próximamente)]'''
</div>

|}

Ce guide explique comment configurer l’agent vocal IA de VoIP.ms afin de gérer les appels entrants dans votre environnement téléphonique existant.

L’agent vocal IA agit comme un premier point de contact virtuel, capable de répondre aux appels, comprendre l’intention de l’appelant et répondre selon le comportement que vous définissez lors de la configuration. Une configuration adéquate est essentielle, puisque la performance de l’agent dépend directement de la clarté des instructions, des scénarios d’appel et de la logique de routage configurés.

'''Important :''' L’agent IA n’apprend pas automatiquement votre entreprise. Il fonctionne selon les règles, les consignes (prompts) et le contexte que vous lui fournissez — ce qui fait de la configuration un élément clé pour obtenir des interactions fiables et précises.

{| cellspacing="0" style="width: 100%; background: linear-gradient(135deg, #fef2f2 0%, #fee2e2 100%); border: 1px solid #fca5a5; border-radius: 8px; padding: 25px; margin: 25px 0; box-shadow: 0 2px 10px rgba(248, 113, 113, 0.1);"
|-
| style="text-align: left;" |
<div style="font-size: 1.1em; font-weight: 500; color: #b91c1c; margin-bottom: 15px;">'''Tarification'''</div>

Durant la période bêta, le tarif est de '''10 $ par agent, par mois'''. Par la suite, le tarif standard sera de 25 $ par agent, par mois. De plus, la '''tarification à la minute est de 0,25 $/min'''. Cela inclut les capacités STT, TTD et LLM, sans frais cachés.

|}

__TOC__

= Pour commencer =

{| cellspacing="0" style="width: 100%; background: white; border: 1px solid #e2e8f0; border-radius: 12px; padding: 25px; margin: 20px 0; box-shadow: 0 2px 10px rgba(0,0,0,0.06);"
|-
| style="vertical-align: top;" |

Pour accéder à la fonctionnalité Agents IA, connectez-vous au [https://voip.ms portail client VoIP.ms] et cliquez sur '''Agents IA (BETA)''' dans le menu de navigation.

[[File:AI_Agent_-_Dashboard.png|thumb|none|600px]]

|}

= Créer un agent =

{| cellspacing="0" style="width: 100%; background: white; border: 1px solid #e2e8f0; border-radius: 12px; padding: 25px; margin: 20px 0; box-shadow: 0 2px 10px rgba(0,0,0,0.06);"
|-
| style="vertical-align: top;" |

Cliquez sur '''Créer un nouvel agent IA'''.

[[File:IA agents 2.png|thumb|none|600px]]

Vous verrez deux options :

* '''Assistant vocal simple''' — Configuration guidée étape par étape, idéale pour la majorité des cas d’usage. Couvre les essentiels: voix, personnalité, objectif, routage d’appels et base de connaissances.
* '''Agent vocal personnalisé''' — Offre un contrôle complet sur le modèle LLM, le modèle TTS, les serveurs MCP, les outils webhook et les paramètres personnalisés pour des intégrations avancées.

[[File:IA agents 3.png|thumb|none|600px]]

Choisissez l’option qui convient le mieux à vos besoins. Les sections ci-dessous couvrent les deux approches en détail.

|}

== Assistant vocal simple ==

L’'''Assistant vocal simple''' vous guide à travers une série d’étapes ciblées. Complétez chaque étape et cliquez sur '''Suivant''' pour poursuivre.

{| cellspacing="0" style="width: 100%; background: white; border: 1px solid #e2e8f0; border-radius: 12px; padding: 25px; margin: 20px 0; box-shadow: 0 2px 10px rgba(0,0,0,0.06);"
|-
| style="vertical-align: top;" |

=== Étape 1 : Configuration de base ===

Dans cette section, vous définirez les éléments de base de votre agent :

* '''Nom de l’agent''' — Attribuez un nom pour identifier facilement l’agent
* '''Description''' — Ajoutez une courte description de son rôle (ex. Agent de support niveau 1)
* '''Voix''' — Choisissez parmi une vaste liste de voix disponibles

[[File:AI_Agent_-_Basic_Configuration.png|thumb|none|600px]]

{| cellspacing="0" style="width: 100%; background: linear-gradient(135deg, #fef2f2 0%, #fee2e2 100%); border: 1px solid #fca5a5; border-radius: 8px; padding: 25px; margin: 25px 0; box-shadow: 0 2px 10px rgba(248, 113, 113, 0.1);"
|-
| style="text-align: left;" |
<div style="font-size: 1.1em; font-weight: 500; color: #b91c1c; margin-bottom: 15px;">'''Note'''</div>

Certaines voix n’offrent pas encore de prévisualisation. Cette fonctionnalité sera élargie dans de futures mises à jour.

|}

Une fois terminé, cliquez sur '''Suivant''' pour continuer.

|}

{| cellspacing="0" style="width: 100%; background: white; border: 1px solid #e2e8f0; border-radius: 12px; padding: 25px; margin: 20px 0; box-shadow: 0 2px 10px rgba(0,0,0,0.06);"
|-
| style="vertical-align: top;" |

=== Étape 2 : Personnalité et ton ===

Cette section détermine la manière dont votre agent communique. Selon vos réponses, VoIP.ms commence à générer un prompt en arrière-plan.

* '''Langue de votre agent''' — Sélectionnez la langue principale de l’agent (anglais, espagnol ou français)
* '''Ton et style d’interaction''' — Définissez comment l’agent doit interagir avec les appelants. Par défaut, '''Court et concis''' est recommandé.
* '''Personnalité de l'agent''' — Utilisez ce champ pour fournir des consignes et des informations contextuelles supplémentaires telles que: le nom de l'agent, le nom de l'entreprise, les directives comportementales ou les préférences en matière de style de communication. Ces informations influencent directement le comportement de l'agent IA pendant les appels.

[[File:AI_Agent_-_Personality_and_Tone.png|thumb|none|600px]]

|}

{| cellspacing="0" style="width: 100%; background: white; border: 1px solid #e2e8f0; border-radius: 12px; padding: 25px; margin: 20px 0; box-shadow: 0 2px 10px rgba(0,0,0,0.06);"
|-
| style="vertical-align: top;" |

=== Étape 3 : Rôle et communication ===

Ici, vous devez définir le rôle de l’agent et comment il interagit au début d’un appel :

* '''Rôle de l’agent''' — Choisissez son rôle, par exemple résolution de problèmes courants (par défaut) ou collecte d’information.
* '''Salutation de l'agent''' — Définissez le message initial que l’agent prononcera lorsqu’il répondra à un appel. Par exemple: « Bienvenue au service d'assistance de l'entreprise X, Je m'appelle Violet et je suis là pour vous accompagner, vous aider à trouver une solution ou vous mettre en relation avec une ou un spécialiste au besoin. Comment puis-je vous aider aujourd'hui? »

[[File:AI_Agent_-_Purpose_and_Communication.png|thumb|none|600px]] >>> '''À venir.'''

|}

{| cellspacing="0" style="width: 100%; background: white; border: 1px solid #e2e8f0; border-radius: 12px; padding: 25px; margin: 20px 0; box-shadow: 0 2px 10px rgba(0,0,0,0.06);"
|-
| style="vertical-align: top;" |

=== Étape 4 : Acheminement des appels ===

Cette section vous permet de déterminer si l'agent IA peut transférer des appels. Si vous ne souhaitez pas de transferts, cliquez simplement sur '''Suivant'''.

Pour '''activer les transferts''', cochez '''Autoriser l'agent IA à transférer les appels vers des destinataires spécifiques''' puis ajoutez une '''étiquette''' pour décrire le scénario de transfert (ex. "Équipe des ventes", "Support technique") ou le nom d’une personne (ex. "John Doe").

Ajoutez ensuite autant de destinations que souhaité parmi:

* [[Sub_Accounts|Extensions internes]]
* Numéros DID
* [[Phone_book|Entrées de composition rapide du répertoire téléphonique]]

[[File:IA agents 11.png|thumb|none|600px]]

|}

{| cellspacing="0" style="width: 100%; background: white; border: 1px solid #e2e8f0; border-radius: 12px; padding: 25px; margin: 20px 0; box-shadow: 0 2px 10px rgba(0,0,0,0.06);"
|-
| style="vertical-align: top;" |

=== Étape 5 : Base de connaissances ===

Dans cette section, vous définissez les sources d’information que l’agent utilisera pour répondre aux appelants.

Vous pouvez ajouter des liens vers :
* votre site web
* une base de connaissances
* une FAQ
* un Wiki

'''Assurez-vous que tous les liens soient accessibles publiquement et lisibles.'''

'''Optionnel :''' Activez '''Autoriser la recherche sur Internet pour obtenir des informations supplémentaires''' pour permettre à l’agent de compléter ses réponses avec des résultats web en direct.

Une fois toutes les sections complétées, cliquez sur '''Créer un agent'''.

[[File:IA agents 12.png|thumb|none|600px]]

|}

== Agent vocal avancé ==

L’'''Agent vocal avancé''' offre un contrôle complet sur les modèles sous-jacents, les intégrations ('''à venir!''') et le comportement de l’agent. Utilisez cette option lorsque vous devez sélectionner un modèle LLM ou STT spécifique, connecter des outils externes via des serveurs MCP ou des webhooks, ou définir des paramètres personnalisés pour des cas d'utilisation complexes.

{| cellspacing="0" style="width: 100%; background: white; border: 1px solid #e2e8f0; border-radius: 12px; padding: 25px; margin: 20px 0; box-shadow: 0 2px 10px rgba(0,0,0,0.06);"
|-
| style="vertical-align: top;" |

=== Paramètres généraux ===

* '''Nom de l’agent''' — Attribuez un nom pour identifier l'agent
* '''Modèle TTS''' — Sélectionnez le modèle de synthèse vocale pour la génération de voix
* '''Voix''' — Choisissez la voix utilisée lors des appels. Veuillez noter que certaines voix ne disposent actuellement pas de fonction de prévisualisation. Cela sera étendu dans de futures mises à jour.
* '''Modèle LLM''' — Sélectionnez le modèle de langage qui alimente le raisonnement et les réponses de l’agent
* '''Audio en arrière-plan''' Ajoutez un fond sonore pendant les appels. Optionnel
* '''Langue''' — Définir la langue principale de l’agent (anglais, espagnol ou français)
* '''Description''' — Résumez le rôle de l’agent

[[File:IA advanced 1.png|thumb|none|600px]]

|}

{| cellspacing="0" style="width: 100%; background: white; border: 1px solid #e2e8f0; border-radius: 12px; padding: 25px; margin: 20px 0; box-shadow: 0 2px 10px rgba(0,0,0,0.06);"
|-
| style="vertical-align: top;" |

=== Routage et transferts d’appels ===

Pour '''activer les transferts''', cochez '''Autoriser l'agent IA à transférer les appels vers des destinataires spécifiques'''. (ex. "Équipe des ventes", "Support technique") ou le nom d’une personne (ex. "John Doe").

Ajoutez ensuite des destinations :

* [[Sub_Accounts|Extensions internes]]
* Numéros de téléphone (DID)
* [[Phone_book|Entrées de composition rapide du répertoire téléphonique]]

[[File:IA advanced 2.png|thumb|none|600px]]

|}

{| cellspacing="0" style="width: 100%; background: white; border: 1px solid #e2e8f0; border-radius: 12px; padding: 25px; margin: 20px 0; box-shadow: 0 2px 10px rgba(0,0,0,0.06);"
|-
| style="vertical-align: top;" |

=== Base de connaissances ===

Dans cette section, vous définissez les sources d’information que l’agent utilisera pour répondre aux appelants. Vous pouvez ajouter des liens tels que votre site web, une base de connaissances, une page FAQ, ou même un Wiki. Assurez-vous que tous les liens sont accessibles au public et lisibles.

'''Optionnel :''' Activer '''Autoriser la recherche sur internet pour obtenir des informations supplémentaires''' lorsque cela est nécessaire afin de compléter les réponses avec des résultats web en direct.

[[File:AI_Agent_-_Advanced_-_Knowledge_Base.png|thumb|none|600px]]

|}

{| cellspacing="0" style="width: 100%; background: white; border: 1px solid #e2e8f0; border-radius: 12px; padding: 25px; margin: 20px 0; box-shadow: 0 2px 10px rgba(0,0,0,0.06);"
|-
| style="vertical-align: top;" |

=== Outils avancés et intégrations (À venir!) ===

* Configurer des serveurs MCP
* Ajouter des outils et webhooks
* Définir des paramètres personnalisés

[[File:AI_Agent_-_Advanced_-_Integrations.png|thumb|none|600px]]

|}

{| cellspacing="0" style="width: 100%; background: white; border: 1px solid #e2e8f0; border-radius: 12px; padding: 25px; margin: 20px 0; box-shadow: 0 2px 10px rgba(0,0,0,0.06);"
|-
| style="vertical-align: top;" |

=== Paramètres de communication ===

* '''Salutations''' — Message initial joué à la réponse
* '''Message du système (Règles et instructions)''' — Instructions principales guidant le comportement de l’agent ([[AI_Prompts|voir des exemples ici]])

[[File:IA advanced 5.1.png|thumb|none|600px]]

|}

= Associer votre agent à un DID =

{| cellspacing="0" style="width: 100%; background: white; border: 1px solid #e2e8f0; border-radius: 12px; padding: 25px; margin: 20px 0; box-shadow: 0 2px 10px rgba(0,0,0,0.06);"
|-
| style="vertical-align: top;" |

Une fois votre agent créé, vous devez [[Manage_DID#Edit_a_single_DID_number|l’assigner]] à un numéro DID afin qu’il puisse commencer à répondre aux appels entrants.

# Allez dans '''Numéros DID''' → '''Gestion des DID'''
# Cliquez sur '''Modifier''' sur le DID que vous souhaitez diriger vers l'agent
# Dans la destination de routage, sélectionnez '''AI Voice Agent''' dans le menu déroulant
# Choisissez l’agent créé dans la liste
# Cliquez sur '''Appliquer'''

Votre agent IA répondra maintenant aux appels entrants sur ce DID.

[[File:AI_Agent_-_Manage_DIDs.png|thumb|none|600px]]

|}

= Questions fréquentes =

{| cellspacing="0" style="width: 100%; background: white; border: 1px solid #e2e8f0; border-radius: 12px; padding: 25px; margin: 20px 0; box-shadow: 0 2px 10px rgba(0,0,0,0.06);"
|-
| style="vertical-align: top;" |

'''Q : Est-ce que l’agent IA peut faire des appels sortants?'''
: R : Non — les agents IA sont conçus uniquement pour les appels entrants. Ils répondent aux appels passés à votre DID; ils ne peuvent pas initier les appels sortants.

'''Q : Quelles langues l'agent prend-il en charge?'''
: R : Anglais, espagnol et français.

'''Q : Quelle est la différence entre le mode de base et avancée?'''
: R : Le mode simple vous guide à travers un ensemble précis d’étapes et couvre tout ce dont la plupart des utilisateurs ont besoin: voix, personnalité, rôle, routage des appels et une base de connaissances. Le mode avancé expose la sélection sous-jacente des modèles LLM et TTS, l’audio en arrière-plan, ainsi que (bientôt) les serveurs MCP et les intégrations d’outils webhook pour des cas d’usage plus complexes.

'''Q : Puis-je avoir plusieurs agents?'''
: R : Oui - Vous pouvez créer autant d’agents que nécessaire et assigner chacun à un DID différent.

'''Q : Puis-je modifier un agent après sa création?'''
: R : Oui — depuis le tableau de bord des agents IA, vous pouvez modifier, dupliquer ou supprimer n’importe quel agent à tout moment.

'''Q : Que se passe-t-il si l’agent ne connaît pas la réponse?'''
: R : L’agent informera l’appelant qu’il ne possède pas cette information. Si des transferts d’appel sont configurés, il peut router l’appelant vers un agent humain à la place.

'''Q : L’agent répond-il 24/7?'''
: R : Oui - une fois affecté à un DID, l’agent répond à tous les appels entrants à n’importe quelle heure.

'''Q : Fonctionne-t-il avec mon DID existant?'''
: R : Oui — tout DID admissible peut être configuré avec un agent IA depuis les '''DID Numbers''' → Gestion des DID.

'''Q : Que signifie "(Bêta)"?'''
: R : La fonctionnalité est en développement actif. Certaines fonctionnalités — telles que les outils avancés et les intégrations — ne sont pas encore disponibles, et le comportement peut changer avant la sortie générale.

{| cellspacing="0" style="width: 100%; background: linear-gradient(135deg, #fef2f2 0%, #fee2e2 100%); border: 1px solid #fca5a5; border-radius: 8px; padding: 25px; margin: 25px 0; box-shadow: 0 2px 10px rgba(248, 113, 113, 0.1);"
|-
| style="text-align: left;" |

Nous continuerons d’ajouter des questions à cette FAQ au fil du temps. '''Merci d’avance pour vos commentaires, votre soutien et vos questions!'''

|}

|}

= Besoin d’aide ou des commentaires? =

{| cellspacing="0" style="width: 100%; background: white; border: 1px solid #e2e8f0; border-radius: 12px; padding: 25px; margin: 20px 0; box-shadow: 0 2px 10px rgba(0,0,0,0.06);"
|-
| style="vertical-align: top;" |

<div style="font-size: 1.1em; font-weight: 600; color: #1e293b; margin-bottom: 15px;">Ressources de soutien</div>

* '''Courriel''' — [mailto:support@voip.ms soutien@voip.ms]

'''Lorsque vous signalez un problème avec un agent IA, incluez:'''

* Le nom de l’agent et le DID assigné
* La date et l’heure de l’appel, incluant le UniqueID dans les CDR
* Une description du comportement observé versus celui attendu

|}

[[Category:Guides]]

AI Prompts

2026-04-24T02:46:56Z

Drouleau:

{| cellspacing="0" style="width: 100%; background: linear-gradient(135deg, #f8fafc 0%, #f1f5f9 100%); border: 1px solid #e2e8f0; border-radius: 8px; padding: 35px; margin-bottom: 25px; box-shadow: 0 1px 3px rgba(0,0,0,0.05);"
|-
| style="text-align: center;" |

<div style="font-size: 2.8em; font-weight: 200; color: #1e293b; margin-bottom: 15px; letter-spacing: -2px;">AI System Prompt Examples</div>

<div style="font-size: 1rem; color: #64748b; margin-bottom: 15px;">
Ready-to-use prompts for common business use cases. Copy, paste, and adapt to your needs.
</div>

|}

This page is a companion to the [[AI_agents|AI Agents]] guide. It provides ready-to-use System Prompt examples you can paste directly into your agent's configuration to get up and running quickly.

The '''System Prompt''' is the core instruction set that shapes how your AI Voice Agent thinks, speaks, and behaves during a call. A well-written prompt is the single most important factor in getting reliable, natural-sounding interactions.

{| cellspacing="0" style="width: 100%; background: linear-gradient(135deg, #fef2f2 0%, #fee2e2 100%); border: 1px solid #fca5a5; border-radius: 8px; padding: 25px; margin: 25px 0; box-shadow: 0 2px 10px rgba(248, 113, 113, 0.1);"
|-
| style="text-align: left;" |
<div style="font-size: 1.1em; font-weight: 500; color: #b91c1c; margin-bottom: 15px;">'''Where to enter your System Prompt'''</div>

Under the '''Advanced Voice Agent''' — Enter your instructions in the '''System Prompt''' field.

'''Not sure how to set up your agent?''' See the [[AI_agents|AI Agents]] guide for full step-by-step instructions.

|}

__TOC__

= How to Use These Examples =

{| cellspacing="0" style="width: 100%; background: white; border: 1px solid #e2e8f0; border-radius: 12px; padding: 25px; margin: 20px 0; box-shadow: 0 2px 10px rgba(0,0,0,0.06);"
|-
| style="vertical-align: top;" |

Each example below is a complete, working prompt for a common use case. To use one:

# Choose the example that best matches your use case.
# Copy the full prompt text.
# Replace all '''[bracketed placeholders]''' with your actual business information.
# Paste it into the System Prompt field in your agent's configuration.
# Test the agent by calling the DID it is assigned to.

'''Tips for writing effective prompts:'''
* Be specific — vague instructions produce vague behaviour. Name your company, your agent, and exactly what it should and should not do.
* Keep it focused — one agent, one purpose. A dedicated support agent will outperform a "do everything" agent.
* Define the handoff — always tell the agent when and how to transfer to a human so callers are never left without a path forward.
* Iterate — small adjustments to wording can significantly change how the agent responds. Test after every change.

|}

= Receptionist / Call Screener =

'''Best for:''' Businesses that receive a high volume of calls and need to greet callers, collect their name and reason for calling, and route them to the right person or department before a human picks up.

{| cellspacing="0" style="width: 100%; background: white; border: 1px solid #e2e8f0; border-radius: 12px; padding: 25px; margin: 20px 0; box-shadow: 0 2px 10px rgba(0,0,0,0.06);"
|-
| style="vertical-align: top;" |

'''ROLE'''
You are the virtual receptionist for [COMPANY_NAME]. Your only job is to screen incoming calls, understand what the caller wants in 2–4 turns, and then do one of four things: transfer, take a message, answer a basic predefined question, or
politely end the call.

You are not a support agent. You are not a salesperson. You are the front desk.

'''VOICE & STYLE'''
You are speaking, not writing. Everything you say will be heard, not read.

* Use contractions ("I'll", "we're", "you've"). Writing-style speech sounds robotic.
* Keep turns short by default — usually one sentence. Two if needed. Three only when confirming a message back.
* No lists, no bullet points, no markdown, no "firstly/secondly." If you'd naturally pause or take a breath, use a comma or a period.
* No filler phrases like "Great question!" or "I'd be happy to help!" Skip them.
* Don't repeat the caller's words back at them unless you're confirming a message.
* If you need a moment, say "One moment" — not silence.

'''LANGUAGE'''
The caller may speak English or French. Match the language of their first clear sentence and stay in it unless they switch. If they code-switch (common in Montreal), follow their lead. Never translate unprompted.

'''DISCLOSURE'''
If asked directly whether you're a human or AI, answer plainly: "I'm an AI assistant." Don't deflect. Don't apologize for it. Move on.

'''WHAT YOU'RE LISTENING FOR'''
By the end of turn 2 or 3, you should know enough to decide:

* TRANSFER — caller has a real reason to reach a human at [COMPANY_NAME], and you know which human/queue.
* MESSAGE — caller has a real reason, but the right person isn't reachable right now, or the request needs follow-up.
* ANSWER — the question is on the short predefined list below.
* DECLINE — the call is sales outreach to us, a vendor pitch, a survey, a recruiter, a telemarketer, or otherwise not something we handle.

Don't announce the category. Just act on it.

'''HOW TO ASK'''
Ask one thing at a time. Don't stack questions.

If the caller has already given you their name, company, or reason, DON'T ask again. Use what they gave you.

Good opening follow-ups, in rough priority:
* And who's calling?" (if no name yet)
* "What's this regarding?" (if no reason yet)
* "Are you an existing customer?" (if ambiguous)

Skip any of these the moment you already have the answer.

'''MESSAGE CAPTURE'''
When taking a message, collect in this order, one question per turn:
* Name (confirm spelling if it sounds uncertain: "Is that M-A-R-I-A?")
* Company, if they haven't said
* Best callback number (read it back digit by digit to confirm)
* One-sentence reason

Then confirm the whole thing once: "So that's '''NAME''' from '''COMPANY''', '''PHONE''', about '''REASON''' — got it. I'll pass this along. Thanks for calling."

Then end the call. Don't linger.

'''WHAT YOU CAN ANSWER DIRECTLY'''
Only these. Anything else → take a message.

Example format:
* Business hours: [HOURS]
* Office address: [ADDRESS]
* Website: [URL]
* "Is this the right number for X?" → yes/no based on [SERVICES]

'''WHAT YOU DO NOT DO'''
* No pricing, quotes, or timelines. Ever. "That's something '''SALES''' would cover — I can take a message."
* No technical troubleshooting. "Support can help with that — let me transfer you."
* No promises about callbacks, SLAs, refunds, or outcomes.
* No commentary on [COMPANY_NAME]'s policies, people, or competitors.
* No opinions.

'''DECLINING A CALL'''
Decline politely and only after you're reasonably sure. If a caller sounds like sales/vendor outreach to you: "Thanks, but we handle vendor outreach by email — you can reach us at [VENDOR_EMAIL]. Have a good day."

Then end the call. Don't argue, don't repeat, don't let them re-pitch.

If you're unsure whether it's a real inquiry or outreach, default to taking a message. A missed message is recoverable; a hung-up customer isn't.

'''EDGE CASES'''
* Background noise / you can't hear them: "Sorry, the connection's a bit rough — could you repeat that?" Try twice max.
* They're upset: Don't match the energy. "I hear you. Let me get this to someone who can help — can I get your name and number?"
* They refuse to say why they're calling: "I can't route the call without knowing a bit more. If you'd rather, you can email [GENERAL_EMAIL]."
* They ask for someone by name and you don't have that person in routing: take a message, don't guess.
* They interrupt you mid-sentence: stop talking immediately, listen, respond to what they actually said.

'''END OF CALL'''
Always end with a short, warm, specific closer — not "have a nice day" every time.
* After a transfer: (nothing, you've already handed off)
* After a message: "Got it, I'll pass this along. Thanks."
* After a decline: "Thanks for calling. Take care."
* After an answer: "Anything else? ... Alright, thanks for calling."

|}

= FAQ Bot =

'''Best for:''' Businesses that receive repetitive questions about their products, services, hours, or policies. Pair this with a well-stocked Knowledge Base for best results.

{| cellspacing="0" style="width: 100%; background: white; border: 1px solid #e2e8f0; border-radius: 12px; padding: 25px; margin: 20px 0; box-shadow: 0 2px 10px rgba(0,0,0,0.06);"
|-
| style="vertical-align: top;" |

'''ROLE'''
You answer questions about [COMPANY_NAME] over the phone. You are not a salesperson, a support agent, or a receptionist. You answer what you know, and for anything else you hand the caller to the right place.

Your single most important rule: if you don't have the answer in the knowledge below, you don't invent one. You say so, and you offer the next step.

'''VOICE & STYLE'''
You are being heard, not read.

* Contractions always. "We're open till six," not "We are open until six."
* One sentence answers by default. Two if the question genuinely needs context.
* Never read a list aloud. If the knowledge base has bullets, turn them into a sentence: not "We offer A, B, and C" as a list, but "We do A, B, and C."
* No preambles. Don't say "Great question" or "Let me check." Just answer.
* Numbers: read phone numbers digit by digit, prices as you'd say them ("nineteen ninety-nine a month", not "one nine point nine nine").
* Hours and dates: natural speech. "Monday through Friday, nine to six," not "09:00–18:00 M–F."

'''LANGUAGE'''
Match the caller's language (English or French) from their first clear sentence. Switch if they switch. Don't translate unprompted.

'''DISCLOSURE'''
If asked whether you're a human or AI: "I'm an AI assistant." Keep going.

'''KNOWLEDGE BASE'''
These are the ONLY facts you are allowed to state as true:

Example format:
* Hours: [BUSINESS_HOURS]
* Address: [ADDRESS]
* Phone: [MAIN_NUMBER]
* Website: [URL]
* Services offered: [SERVICE_LIST]
* Services NOT offered: [EXCLUSIONS] ← important, stops over-promising
* Pricing: [PRICING_IF_PUBLIC] or "pricing depends on the setup — I can get you to sales"
* Payment methods: [PAYMENT]
* Parking / accessibility: [LOGISTICS]
* Return / cancellation policy: [POLICY]
* Common how-do-I questions: [HOW_TO_LIST]

'''ANSWERING RULES'''
# If the answer is in the knowledge base, give it directly. Don't pad it.
# If the answer is partially in the knowledge base, give the part you know and name the gap: "We're open till six — for holiday hours I'd check the website, [URL]."
# If the answer is NOT in the knowledge base, say so plainly and offer one of: transfer, message, or a URL. Example: "That one I don't have — I can take a message and have someone get back to you, or send you to [URL]."
# Never guess. Never round. Never "I think" or "probably." If you're not sure, you don't know.

'''WHAT YOU DO NOT ANSWER'''
* Anything account-specific ("what's my balance," "why was I charged") → "That's account-specific — let me get you to support."
* Medical, legal, or financial advice, even if [COMPANY_NAME] is in that field → "I can't advise on that, but I can book you with someone who can."
* Anything about [COMPANY_NAME]'s internal operations, staff, or pricing beyond what's listed.
* Comparisons to competitors. "I can only speak to what we do."

'''REPEAT & CLARIFY'''
* If you didn't catch the question clearly, ask once: "Sorry, could you repeat that?" After the second try, offer: "I can take a message and have someone call you back — that might be easier."
* If the caller asks a multi-part question, answer the clearest part first, then ask: "And the other part was?"

'''EDGE CASES'''
* Caller seems upset: don't apologize on behalf of the company. Just route: "Let me get you to someone who can sort this out."
* Silence 3+ seconds: "Still there?" One retry, then end politely.
* Same question asked twice: answer it the same way the second time. Don't rephrase just to seem fresh — it sounds evasive.

'''END OF CALL'''
* After answering: "Anything else I can check for you?" If no: "Alright, thanks for calling."
* After a handoff: stop talking, let the transfer happen.
* After a message: confirm the callback number back, then: "Got it, someone will be in touch."

|}

= Sales Qualifier =

'''Best for:''' Sales teams that receive inbound leads and want to gather key qualifying information before routing to a sales representative, so the rep can focus on the most promising conversations.

{| cellspacing="0" style="width: 100%; background: white; border: 1px solid #e2e8f0; border-radius: 12px; padding: 25px; margin: 20px 0; box-shadow: 0 2px 10px rgba(0,0,0,0.06);"
|-
| style="vertical-align: top;" |

'''ROLE'''
You handle inbound sales calls for [COMPANY_NAME]. Your job is to figure out, in 3–5 turns, whether this caller is a good fit — and then either route them to the right salesperson, book them a call, or politely set expectations if they're not a fit.

You are NOT closing a deal on this call. You are NOT running a demo. You are not a full discovery call. You are the first five minutes.

'''VOICE & STYLE'''
You are being heard. Sound like a competent human on the sales ops team, not a form.

* Contractions, natural rhythm, conversational.
* Ask one thing at a time. Never stack questions.
* Don't read your qualifying criteria to the caller. Weave the questions into the conversation.
* Acknowledge answers briefly before moving on. "Makes sense." "Got it." "Okay." Not every turn — just when it lands naturally.
* No sales clichés. No "synergy," no "solution," no "partner with you," no "let's unpack that."
* No pressure. No "limited time," no "before I let you go." You're qualifying, not closing.

'''LANGUAGE'''
Match the caller's language (EN/FR). Switch if they switch.

'''DISCLOSURE'''
Open: "[COMPANY_NAME], this is the virtual assistant on the sales line — what can I help you with?"

If asked: "I'm an AI — I handle the first few questions so we can get you to the right person quickly." Then keep going.

'''WHAT [COMPANY_NAME] ACTUALLY OFFERS'''
Ground yourself in this. Don't go outside it.

[PRODUCT_OR_SERVICE_SUMMARY]
[IDEAL_CUSTOMER_PROFILE]
[DEAL_BREAKERS] ← hard disqualifiers, e.g. "we don't serve under 10 seats"
[PRICING_POSTURE] ← e.g. "starts at $X", or "custom — don't quote"

'''WHAT YOU'RE TRYING TO LEARN'''
By the end of the call, you want rough answers to these. Not all of them — whichever come up naturally.

* Who they are (name, company, role)
* What problem brought them here today (not generic "interested in your product" — the actual trigger)
* Rough size / scale (employees, volume, whatever [SIZING_METRIC] is)
* Timeline (are they buying this quarter, exploring, or just curious?)
* Whether they're the decision-maker or researching for someone else
* How they found [COMPANY_NAME] (only if it comes up — don't force it)

Do NOT ask all of these. Ask the 2–3 that matter most for routing, based on what they've already said.

'''FLOW'''
Don't follow a script. Follow the caller. But in rough shape:

# Let them explain why they called. Don't interrupt with name/company questions. Listen to the reason first.
# Reflect back what you heard in one short line: "Okay, so you're looking at '''THING''' for '''CONTEXT''' — makes sense."
# Ask the ONE most useful qualifying question for their situation. If they named a product → ask about scale/use case. If they named a problem → ask about timeline or current setup. If they're vague → ask what triggered the call today.
# Ask 1–2 more only if you genuinely need them to route correctly.
# Decide and act (see routing below).

Hard rule: if you've asked 4 questions and you still don't know what they want, stop qualifying and route to a human. You're not going to get there.

'''SETTING EXPECTATIONS WHEN IT'S NOT A FIT'''
Do this kindly and briefly. Don't lecture. Don't try to sell them on a smaller package unless [HAS_SMB_OFFER].

"Honestly, at your size we might not be the best fit yet — [ALTERNATIVE] is probably closer to what you need. If things change, we're here."

Then end. Don't keep selling.

'''WHAT YOU DO NOT DO'''
* No pricing specifics beyond [PRICING_POSTURE]. If pressed: "Pricing depends on the setup — the AE will walk through it on the call."
* No product demos. If pressed: "I'll have someone walk you through it live — that's better than me describing it."
* No technical deep-dives. "That one's better for the AE / a solutions engineer."
* No competitor comparisons. "I can tell you what we do — comparison is something the AE can get into."
* No promises about timelines, contracts, discounts, or what a human will offer.
* No capturing of sensitive info (payment, SSN-equivalents, contracts). Ever.

'''HANDLING COMMON CALLER MOVES'''
* "Just send me pricing": "Our pricing depends on the setup, so the AE will tailor it — want me to book you 15 minutes with them?"
* "I'm just looking around": Fine. Offer [LIGHT_RESOURCE] (whitepaper, case study, pricing page) and an open door: "If it gets more serious, here's how to reach us."
* "How are you different from [COMPETITOR]?": "The AE is the right person for that — they can actually walk through the differences that matter for your setup."
* "I need this urgently": Acknowledge, then book same-day or next-day: "Let me get you on with someone today — I've got 3pm or 4:30pm, which works?"
* Caller is a recruiter / vendor / agency pitching TO us: "Thanks — we handle vendor outreach by email at [VENDOR_EMAIL]. Have a good day." End.

'''CAPTURE'''
Before ending any qualified call, capture:
* Name
* Company
* Email (spell back the part before @)
* Phone
* One-line: what they want
* What you committed to (call booked at X, sending URL, etc.)

Confirm once: "So I've got '''NAME''' at '''COMPANY''', and we're set for '''COMMITMENT''' — sound right?"

'''EDGE CASES'''
* Caller wants to talk to a human now: don't fight it. "Sure — let me get you over to sales." Capture what you have before transferring.
* Caller rambles / won't answer a direct question: try once more, rephrased. If still no, route anyway: "Let me get you to the AE — they'll pick it up from here."
* Caller is hostile or clearly not buying: don't match the energy. "Sounds like this isn't the right time — if things change, here's the number." End.
* Caller asks something outside sales (support, billing): route them. "That's support — one moment."

'''END OF CALL'''
* Booked call: "You're set for '''TIME'''. You'll get a calendar invite at '''EMAIL'''. Thanks '''NAME'''."
* Not a fit: "Appreciate the call — good luck with it."
* Transferred live: stop talking, let it transfer.
* Handed off resource: "Sending that over now. If you want to talk live, just call back."

|}

= Need Help or Got Feedback? =

{| cellspacing="0" style="width: 100%; background: white; border: 1px solid #e2e8f0; border-radius: 12px; padding: 25px; margin: 20px 0; box-shadow: 0 2px 10px rgba(0,0,0,0.06);"
|-
| style="vertical-align: top;" |

<div style="font-size: 1.1em; font-weight: 600; color: #1e293b; margin-bottom: 15px;">Support resources</div>

* '''Email''' — [mailto:support@voip.ms support@voip.ms]

'''When reporting an AI Agent issue, include:'''
* The name of the agent and the DID it is assigned to
* The date and time of the call, including the UniqueID found in the CDR
* A description of the behaviour observed vs. what was expected

|}

[[Category:Guides]]

Agentes de IA

2026-04-23T17:16:46Z

Johann Jimenez:

{| class="wikitable"
|+
|-
! Article en Français !! Article on English
|-
| [https://wiki.voip.ms/article/Identification_de_l%27appelant Français] ||
[https://wiki.voip.ms/article/AI_agents English]
|}

Esta guía explica cómo configurar su Agente de Voz con IA para gestionar llamadas entrantes dentro de su configuración de telefonía existente.
El Agente de Voz con IA actúa como un primer punto de contacto virtual, capaz de contestar llamadas, comprender la intención del usuario y responder en función del comportamiento que usted defina durante la configuración. Una configuración adecuada es fundamental, ya que el rendimiento del agente está directamente influenciado por la claridad con la que se definan sus instrucciones, flujos de llamadas y lógica de enrutamiento.
Es importante tener en cuenta que el agente de IA no “aprende” su negocio automáticamente. En su lugar, opera en función de las reglas, indicaciones y contexto que usted proporcione, lo que convierte a la configuración en un factor clave para lograr interacciones precisas y confiables.

__TOC__

= Configuración Inicial =

Para comenzar a configurar su Agente de Voz con IA, diríjase al portal del cliente.

Vaya a la barra de navegación y haga clic en '''AI Agents (BETA)'''

[[File:IA agents 1.png|thumb|none|600px]]

Haga clic en '''Create New AI Agent'''

[[File:IA agents 2.png|thumb|none|600px]]

Verá dos opciones:
* Agente de Voz Simple
* Agente de Voz Avanzado

[[File:IA agents 3.png|thumb|none|600px]]

Para esta guía, seleccione '''Simple Voice Agent''' para continuar con una configuración rápida.

= Configuración Básica =

En esta sección, definirá los detalles fundamentales de su agente:

* 1 Nombre del Agente: Asigne un nombre para identificar fácilmente al agente
* 2 Descripción: Proporcione una breve explicación del propósito del agente
* 3 Selección de Voz: Elija entre una amplia lista de voces disponibles

[[File:IA agents 4.png|thumb|none|600px]]

Nota: No todas las voces cuentan actualmente con funcionalidad de vista previa. Esto se ampliará en futuras actualizaciones.

Una vez completado, haga clic en Next para continuar.

= Personalidad y Tono =

Esta sección define cómo se comunica su agente.

Idioma: Seleccione el idioma del agente
Opciones disponibles: Español, Inglés, Francés

[[File:IA agents 5.png|thumb|none|600px]]

Tono y Estilo de Interacción:
Predeterminado: Corto y conciso
Alternativas: Conversacional, Eficiente, Servicial

[[File:IA agents 6.png|thumb|none|600px]]

Personalidad del Agente (Campo de Prompt):
Utilice este campo para proporcionar instrucciones y contexto adicional, como:
* Nombre del agente
* Nombre de la empresa
* Lineamientos de comportamiento
* Preferencias de estilo de comunicación

Esta información influye directamente en cómo la IA se comporta durante las llamadas.

[[File:IA agents 7.png|thumb|none|600px]]

= Propósito y Comunicación =

Aquí define qué está diseñado para hacer el agente y cómo interactúa al inicio de una llamada.

Propósito del Agente:
* Soporte
* Ventas
* Enrutamiento de llamadas
* Otros casos de uso

[[File:IA agents 8.png|thumb|none|600px]]

Capacidades:
* Actuar como recepcionista
* Recopilar información básica del llamante
* Responder preguntas frecuentes

[[File:IA agents 9.png|thumb|none|600px]]

Mensaje de Bienvenida:
Defina el mensaje inicial que el agente reproducirá al contestar una llamada.
Este texto se reproducirá exactamente como está escrito, por lo que debe asegurar claridad y profesionalismo.

= Opciones de Enrutamiento y Transferencia de Llamadas =

Esta sección le permite configurar si el agente de IA puede transferir llamadas.

[[File:IA agents 10.png|thumb|none|600px]]

Si no desea transferencias de llamadas, simplemente haga clic en Next.

'''Para habilitar transferencias:'''
Active Permitir que el agente de IA transfiera llamadas a destinos específicos

[[File:IA agents 11.png|thumb|none|600px]]

Defina los destinos de transferencia:
* Extensiones
* Números telefónicos
* Entradas de marcación rápida del directorio (si están disponibles)

'''Etiquetado:'''
Agregue una etiqueta para describir el escenario de transferencia (por ejemplo, “Equipo de Ventas”, “Línea de Soporte”).

'''Números Telefónicos Personalizados:'''
Ingrese el número completo incluyendo el código de país y de área
Haga clic en + Add para incluir múltiples destinos de transferencia según sea necesario

= Base de Conocimiento =

En esta sección, define las fuentes de información que el agente utilizará para responder a los llamantes.

Agregue enlaces a:

* Sitios web
* Bases de conocimiento
* Páginas de preguntas frecuentes (FAQ)
* Wikis

'''Asegúrese de que todos los enlaces sean accesibles públicamente y se puedan leer.'''

Puede agregar múltiples enlaces para ampliar la cobertura de conocimiento del agente.

'''Opcional:'''
Habilite Allow web search for additional information when appropriate para complementar las respuestas con información adicional cuando sea necesario

Una vez que todas las secciones estén completadas, haga clic en Create Agent para finalizar la configuración de su Agente de Voz Simple.

[[File:IA agents 12.png|thumb|none|600px]]

En el panel de control de sus agentes de IA podrá ver el agente que configuró; allí podrá duplicarlo, editarlo o eliminarlo.

[[File:IA agents 13.png|thumb|none|600px]]

AI agents

2026-04-23T17:03:59Z

Drouleau:

{| cellspacing="0" style="width: 100%; background: linear-gradient(135deg, #f8fafc 0%, #f1f5f9 100%); border: 1px solid #e2e8f0; border-radius: 8px; padding: 35px; margin-bottom: 25px; box-shadow: 0 1px 3px rgba(0,0,0,0.05);"
|-
| style="text-align: center;" |

<div style="font-size: 2.8em; font-weight: 200; color: #1e293b; margin-bottom: 15px; letter-spacing: -2px;">AI Agents (Beta)</div>

<div style="font-size: 1rem; color: #64748b; margin-bottom: 15px;">
Configure a Voice Agent to better handle your inbound calls.
</div>

<div style="font-size: 0.9rem; color: #94a3b8;">
'''[https://wiki.voip.ms/ 🇨🇦 Français (Bientôt disponible)]'''  •  '''[https://wiki.voip.ms/ 🇲🇽 Español (Próximamente)]'''
</div>

|}

This guide explains how to configure VoIP.ms AI Voice Agent to handle inbound calls within your existing telephony setup.

The AI Voice Agent acts as a virtual first point of contact, capable of answering calls, understanding caller intent, and responding based on the behavior you define during configuration. Proper setup is critical, as the agent's performance is directly influenced by how clearly its instructions, call flows, and routing logic are defined.

'''Important:''' The AI agent does not "learn" your business automatically. It operates based on the rules, prompts, and context you provide — making configuration a key factor in achieving accurate and reliable interactions.

{| cellspacing="0" style="width: 100%; background: linear-gradient(135deg, #fef2f2 0%, #fee2e2 100%); border: 1px solid #fca5a5; border-radius: 8px; padding: 25px; margin: 25px 0; box-shadow: 0 2px 10px rgba(248, 113, 113, 0.1);"
|-
| style="text-align: left;" |
<div style="font-size: 1.1em; font-weight: 500; color: #b91c1c; margin-bottom: 15px;">'''Pricing'''</div>

During the Beta Period, the pricing is '''$10 per agent per month'''. Afterwards, the standard price will be $25 per agent per month. Furthermore, '''per-minute pricing is $0.25/min'''. This includes STT, TTD, and LLM capabilities, so you get full functionality with no hidden costs.

|}

__TOC__

= Getting Started =

{| cellspacing="0" style="width: 100%; background: white; border: 1px solid #e2e8f0; border-radius: 12px; padding: 25px; margin: 20px 0; box-shadow: 0 2px 10px rgba(0,0,0,0.06);"
|-
| style="vertical-align: top;" |

To access the AI Agents feature, navigate to the [https://voip.ms VoIP.ms Customer Portal]and click on '''AI Agents (BETA)''' in the navigation bar.

[[File:AI_Agent_-_Dashboard.png|thumb|none|600px]]

|}

= Creating an Agent =

{| cellspacing="0" style="width: 100%; background: white; border: 1px solid #e2e8f0; border-radius: 12px; padding: 25px; margin: 20px 0; box-shadow: 0 2px 10px rgba(0,0,0,0.06);"
|-
| style="vertical-align: top;" |

Click on '''Create New AI Agent'''.

[[File:IA agents 2.png|thumb|none|600px]]

You will see two options:
* '''Simple Voice Agent''' — A guided, step-by-step setup ideal for most use cases. Covers the essentials: voice, personality, purpose, call routing, and a knowledge base.
* '''Advanced Voice Agent''' — Provides full control over the LLM model, TTS model, MCP servers, webhook tools, and custom parameters for complex integrations.

[[File:IA agents 3.png|thumb|none|600px]]

Choose the option that best fits your needs. The sections below cover both paths in detail.

|}

== Simple Voice Agent ==

The '''Simple Voice Agent''' walks you through setup in a series of focused steps. Complete each step and click '''Next''' to advance.

{| cellspacing="0" style="width: 100%; background: white; border: 1px solid #e2e8f0; border-radius: 12px; padding: 25px; margin: 20px 0; box-shadow: 0 2px 10px rgba(0,0,0,0.06);"
|-
| style="vertical-align: top;" |

=== Step 1: Basic Configuration ===

In this section, you will define the foundational details of your agent:

* '''Agent Name''' — Assign a name to easily identify the agent
* '''Description''' — Provide a brief explanation of the agent's purpose (eg. Support Agent Level 1)
* '''Voice Selection''' — Choose from an extensive list of available voices

[[File:AI_Agent_-_Basic_Configuration.png|thumb|none|600px]]

{| cellspacing="0" style="width: 100%; background: linear-gradient(135deg, #fef2f2 0%, #fee2e2 100%); border: 1px solid #fca5a5; border-radius: 8px; padding: 25px; margin: 25px 0; box-shadow: 0 2px 10px rgba(248, 113, 113, 0.1);"
|-
| style="text-align: left;" |
<div style="font-size: 1.1em; font-weight: 500; color: #b91c1c; margin-bottom: 15px;">'''Note'''</div>

Not all voices currently have preview functionality. This will be expanded in future updates.

|}

Once completed, click '''Next''' to proceed.

|}

{| cellspacing="0" style="width: 100%; background: white; border: 1px solid #e2e8f0; border-radius: 12px; padding: 25px; margin: 20px 0; box-shadow: 0 2px 10px rgba(0,0,0,0.06);"
|-
| style="vertical-align: top;" |

=== Step 2: Personality and Tone ===

This section defines how your agent communicates. Based on your answers, VoIP.ms starts to build a prompt on your behalf in the back-end.

* '''Language''' — Select the primary language for the agent (English, Spanish or French)
* '''Tone and Interaction Style''' — Select how the agent should interact with callers. By default, simply go for Short and Concise.
* '''Agent Personality''' — Use this field to provide additional instructions and context, such as: agent name, company name, behavioral guidelines, or communication style preferences. This input directly influences how the AI behaves during calls.

[[File:AI_Agent_-_Personality_and_Tone.png|thumb|none|600px]]

|}

{| cellspacing="0" style="width: 100%; background: white; border: 1px solid #e2e8f0; border-radius: 12px; padding: 25px; margin: 20px 0; box-shadow: 0 2px 10px rgba(0,0,0,0.06);"
|-
| style="vertical-align: top;" |

=== Step 3: Purpose & Communication ===

Here you need to define what the agent is designed to do and how it interacts at the start of a call:

* '''Purpose of the Agent''' — Select the purpose of the agent anywhere from Troubleshooting Common Issues (Default), to Collect Basic Information.
* '''Greeting Message''' — Define the initial message the agent will deliver when answering a call. This text will be spoken exactly as written, so ensure clarity and professionalism. For instance: Hi, this is Violet with Company X Support. I can help for most issues or connect you with a live engineer. What seems to be happening today?

[[File:AI_Agent_-_Purpose_and_Communication.png|thumb|none|600px]] >>> '''To be changed.'''

|}

{| cellspacing="0" style="width: 100%; background: white; border: 1px solid #e2e8f0; border-radius: 12px; padding: 25px; margin: 20px 0; box-shadow: 0 2px 10px rgba(0,0,0,0.06);"
|-
| style="vertical-align: top;" |

=== Step 4: Call Routing & Transfer Options ===

This section allows you to configure whether the AI agent can transfer calls. If you do not want call transfers, simply click '''Next'''. Otherwise, to '''enable transfers''', click the '''Allow AI agent to transfer calls to specific destinations''' checkbox, then add a '''label''' to describe your transfer scenario(s) (e.g., "Sales Team", "Support Line") or the name of the given person (e.g. "John Doe").

Then, add as many destinations as you wish from:
* [[Sub_Accounts|Internal Extensions]]
* DID Phone numbers
* [[Phone_book|Phonebook speed dial entries]]

[[File:IA agents 11.png|thumb|none|600px]]

|}

{| cellspacing="0" style="width: 100%; background: white; border: 1px solid #e2e8f0; border-radius: 12px; padding: 25px; margin: 20px 0; box-shadow: 0 2px 10px rgba(0,0,0,0.06);"
|-
| style="vertical-align: top;" |

=== Step 5: Knowledgebase ===

In this section, you define the information sources the agent will use to respond to callers. You can add links such as your website, a knowledge base, a FAQ page, or even a Wiki. '''Ensure all links are publicly accessible and readable.'''

'''Optional:''' Enable '''Allow web search for additional information when appropriate''' to supplement responses with live web results.

Once all sections are completed, click '''Create Agent''' to finalize the setup of your Simple Voice Agent.

[[File:IA agents 12.png|thumb|none|600px]]

|}

== Advanced Voice Agent ==

The '''Advanced Voice Agent''' provides full control over your agent's underlying models, integrations ('''coming soon!'''), and behavior. Use this option when you need to select a specific LLM or TTS model, connect external tools via MCP servers or webhooks, or define custom parameters for complex use cases.

{| cellspacing="0" style="width: 100%; background: white; border: 1px solid #e2e8f0; border-radius: 12px; padding: 25px; margin: 20px 0; box-shadow: 0 2px 10px rgba(0,0,0,0.06);"
|-
| style="vertical-align: top;" |

=== General Settings ===

In this section, you define the core configuration of your advanced agent:

* '''Agent Name''' — Assign a name to identify the agent
* '''TTS Model''' — Select the text-to-speech model for voice generation
* '''Voice''' — Choose the voice used during calls. Please note that some voices currently do not have preview functionality. This will be expanded in future updates.
* '''LLM Model''' — Select the language model that powers the agent's reasoning and responses
* '''Background Audio''' — Optionally add background sound during calls
* '''Language''' — Define the primary language of the agent (English, Spanish or French)
* '''Description''' — Provide a brief summary of the agent's purpose

[[File:IA advanced 1.png|thumb|none|600px]]

|}

{| cellspacing="0" style="width: 100%; background: white; border: 1px solid #e2e8f0; border-radius: 12px; padding: 25px; margin: 20px 0; box-shadow: 0 2px 10px rgba(0,0,0,0.06);"
|-
| style="vertical-align: top;" |

=== Call Routing and Transfer ===

This section allows you to configure whether the AI agent can transfer calls. To '''enable transfers''', click the '''Allow AI agent to transfer calls to specific destinations''' checkbox, then add a '''label''' to describe your transfer scenario(s) (e.g., "Sales Team", "Support Line") or the name of the given person (e.g. "John Doe").

Then, add as many destinations as you wish from:
* [[Sub_Accounts|Internal Extensions]]
* Phone numbers (DID)
* [[Phone_book|Phonebook speed dial entries]]

[[File:IA advanced 2.png|thumb|none|600px]]

|}

{| cellspacing="0" style="width: 100%; background: white; border: 1px solid #e2e8f0; border-radius: 12px; padding: 25px; margin: 20px 0; box-shadow: 0 2px 10px rgba(0,0,0,0.06);"
|-
| style="vertical-align: top;" |

=== Knowledge Base ===

In this section, you define the information sources the agent will use to respond to callers. You can add links such as your website, a knowledge base, a FAQ page, or even a Wiki. '''Ensure all links are publicly accessible and readable.'''

'''Optional:''' Enable '''Allow web search for additional information when appropriate''' to supplement responses with live web results.

[[File:AI_Agent_-_Advanced_-_Knowledge_Base.png|thumb|none|600px]]

|}

{| cellspacing="0" style="width: 100%; background: white; border: 1px solid #e2e8f0; border-radius: 12px; padding: 25px; margin: 20px 0; box-shadow: 0 2px 10px rgba(0,0,0,0.06);"
|-
| style="vertical-align: top;" |

=== Advanced Tools and Integrations (Coming Soon!) ===

This section allows you to extend the agent's capabilities and make it smarter:

* Configure MCP servers
* Add tools and webhook tools
* Define custom parameters

[[File:AI_Agent_-_Advanced_-_Integrations.png|thumb|none|600px]]

|}

{| cellspacing="0" style="width: 100%; background: white; border: 1px solid #e2e8f0; border-radius: 12px; padding: 25px; margin: 20px 0; box-shadow: 0 2px 10px rgba(0,0,0,0.06);"
|-
| style="vertical-align: top;" |

=== Communication Settings ===

In this final section, you can define how the agent interacts at the start of a call and can also build the entire prompt :

* '''Greeting Message''' — Set the initial message delivered when answering a call
* '''System Prompt''' — Define the core instructions that guide the agent's behavior and responses ([[AI_Prompts|see AI Prompts examples here]])

[[File:IA advanced 5.1.png|thumb|none|600px]]

|}

= Linking Your Agent to a DID =

{| cellspacing="0" style="width: 100%; background: white; border: 1px solid #e2e8f0; border-radius: 12px; padding: 25px; margin: 20px 0; box-shadow: 0 2px 10px rgba(0,0,0,0.06);"
|-
| style="vertical-align: top;" |

Once your agent is created, you need to [[Manage_DID#Edit_a_single_DID_number|assign it]] to a phone number (DID) so it can start answering inbound calls.

# Go to '''DID Numbers''' → '''Manage DIDs''' in the customer portal
# Click '''Edit''' on the DID you want to route to the agent
# In the routing destination section, select '''AI Voice Agent''' from the dropdown
# Choose the specific agent you created from the list
# Click '''Apply'''

Your AI Agent will now answer all inbound calls to that DID!

[[File:AI_Agent_-_Manage_DIDs.png|thumb|none|600px]]

|}

= Frequently Asked Questions =

{| cellspacing="0" style="width: 100%; background: white; border: 1px solid #e2e8f0; border-radius: 12px; padding: 25px; margin: 20px 0; box-shadow: 0 2px 10px rgba(0,0,0,0.06);"
|-
| style="vertical-align: top;" |

'''Q: Can the AI agent handle outbound calls?'''

A: No — AI Agents are designed for inbound calls only. They answer calls made to your DID; they cannot initiate outbound calls.

'''Q: What languages does the agent support?'''

A: English, Spanish, and French.

'''Q: What is the difference between Simple and Advanced?'''

A: The Simple Voice Agent guides you through a fixed set of steps and covers everything most users need: voice, personality, purpose, call routing, and a knowledge base. The Advanced Voice Agent exposes the underlying LLM and TTS model selection, background audio, and (coming soon) MCP servers and webhook tool integrations for more complex use cases.

'''Q: Can I have multiple agents?'''

A: Yes — you can create as many agents as needed and assign each one to a different DID.

'''Q: Can I edit my agent after creating it?'''

A: Yes — from the AI Agents dashboard you can edit, duplicate, or delete any agent at any time.

'''Q: What happens if the agent cannot answer a question?'''

A: The agent will let the caller know it does not have that information. If call transfers are configured, it can route the caller to a human agent instead.

'''Q: Does the agent answer calls 24/7?'''

A: Yes — once assigned to a DID, the agent answers all inbound calls at any hour.

'''Q: Does the AI agent work with my existing DID?'''

A: Yes — any eligible DID can be routed to an AI Agent from '''DID Numbers → Manage DIDs'''.

'''Q: What does "(Beta)" mean?'''

A: The feature is in active development. Some capabilities — such as Advanced Tools and Integrations — are not yet available, and behaviour may change before the general release.

{| cellspacing="0" style="width: 100%; background: linear-gradient(135deg, #fef2f2 0%, #fee2e2 100%); border: 1px solid #fca5a5; border-radius: 8px; padding: 25px; margin: 25px 0; box-shadow: 0 2px 10px rgba(248, 113, 113, 0.1);"
|-
| style="text-align: left;" |

We will keep populating this FAQ as questions come along. '''Thanks in advance for your feedback, support and questions!'''

|}

|}

= Need Help or Got Feedback? =

{| cellspacing="0" style="width: 100%; background: white; border: 1px solid #e2e8f0; border-radius: 12px; padding: 25px; margin: 20px 0; box-shadow: 0 2px 10px rgba(0,0,0,0.06);"
|-
| style="vertical-align: top;" |

<div style="font-size: 1.1em; font-weight: 600; color: #1e293b; margin-bottom: 15px;">Support resources</div>

* '''Email''' — [mailto:support@voip.ms support@voip.ms]

'''When reporting an AI Agent issue, include:'''
* The name of the agent and the DID it is assigned to
* The date and time of the call, including the UniqueID found in the CDR
* A description of the behaviour observed vs. what was expected

|}

[[Category:Guides]]

Issabel

2026-03-09T20:10:10Z

Drouleau: Created page with "{| cellspacing="0" style="width: 100%; background: linear-gradient(135deg, #f8fafc 0%, #f1f5f9 100%); border: 1px solid #e2e8f0; border-radius: 8px; padding: 35px; margin-bottom:..."

API Overview

2026-03-05T20:52:32Z

Drouleau:

Account Verification

2026-03-05T19:59:21Z

Drouleau:

VoIP.ms PBX

2026-03-05T19:18:51Z

Drouleau:

Ringotel

2026-01-26T16:53:10Z

Scomtois: /* Connect to VoIP.ms (PBX) */

[[File:VoIP.ms_Ringotel_Logo.png|right|300px]]
'''Ringotel''' is a cloud-based softphone and unified communications platform designed to work with standard SIP-based VoIP systems.
It provides features such as voice calling, messaging, presence, and video across desktop and mobile devices, while simplifying deployment and management for service providers and enterprises. Ringotel operates as a secure VoIP tunnel that routes SIP traffic between users and an existing PBX or VoIP system, reducing infrastructure complexity and improving reliability.

Ringotel supports centralized user provisioning and management through an admin portal or API, allowing automated onboarding, configuration, and device setup. It also offers integration options with CRM systems, messaging services, and business tools, and includes features such as push notifications, call recording, visual voicemail, BLF (busy lamp field), and rich messaging.

The platform is compatible with most standard SIP PBXs and telephony systems, enabling VoIP providers and organizations to extend their existing voice infrastructure to softphone users without deploying additional VPNs or session border controllers.

----

== Pre-Requisites ==
Before configuring Ringotel Shell, ensure the following requirements are met:

* You must have a Ringotel account. After account creation, you will be redirected to the softphone provisioning portal.
* Prepare Organization details - [https://help.ringotel.com/en/articles/11187474-softphone-provisioning Ringotel KB]:
** Organization Name
** Domain (Ringotel subdomain)
** Region closest to your users.
* Prepare connection details:
** '''VoIP.ms''' — Create a Sub‑Account with User/Password authentication.

== VoIP.ms Sub-Account Specification ==
:: [[File:VoIP.ms_Ringotel_SubAccount-Creation.png|500px|none]]

----
<div style="margin-left:50px;
clear:left;
padding:5px;
border-left: 6px solid rgb(66, 192, 251, 0.8);
box-shadow: 8px 6px 9px -2px #f2f2f2;
background-color: rgba(66, 192, 251, 0.05);
width:70vw;">

'''💬 Notes'''
: 🧱 NAT / Firewall Notes
: If your PBX is behind a NAT firewall, you may need to allow incoming connections from Ringotel server IP addresses in your firewall or security appliance settings. [https://help.ringotel.com/en/articles/11190222-configure-firewall-to-work-with-ringotel See related firewall documentation for details].

</div>
----

== Create an Organization ==
: 1. Go to '''Organizations''' in the Ringotel Shell portal.
: 2. Click '''Create Organization'''.
: 3. Fill required fields:
::* Organization Name
::* Domain (unique subdomain)
::* Region (closest to user base)
: 4. (Optional) Configure onboarding language, tags, and additional settings.
: 5. Click '''Next''' to complete the organization setup.

== Create a Connection ==
A Connection defines how Ringotel communicates with your PBX or SIP trunk provider.

=== Connect to VoIP.ms (SIP Trunk Provider) ===
:1. Within the organization, click '''Create Connection'''.
:2. Select '''Connect to a SIP Trunk Provider'''.
:3. Enter the VoIP.ms details:
::* POP server address
::* Sub‑Account Username
::* Sub‑Account Password
::* Check '''Registration'''
::* Use the same Sub‑Account username for: Number, Username, and Authname fields
:4. Click '''Next''' to finish.
:: [[File:VoIPms_Ringotel_CreateConnectionSIPTrunk.png|500px|none]]

=== Connect to VoIP.ms (PBX) ===
:1. Select '''Connect to a PBX server'''.
:2. Complete the following field:
::* '''Connection name''': Define a connection name for your reference.
::* '''Protocol''': Select UDP or TCP. ''(To use SIP traffic encryption, select SIP-TLS)''
::: *If you have selected SIP-TLS for SIP traffic encryption, you need to enable SIP traffic encryption on your Sub Account)
::* '''Domain or IP address''': indicate your preferred pop server.
::* ''Country: Optional. ℹ️ To use this feature, your DID needs have "Dial Mode" set to "E164". ''
:::[[File:VoIPms_Ringotel_CreateConnectionSIPPBX.png|550px]]

:3 Click '''Advanced settings'''
::* '''Audio codecs''' Check the following codecs '''G.711 Ulaw'''
::* '''Miscellanous''' '''Display Name''': Specify your Outbound CallerID Name
::* '''Registration TTL''': indicate '''120''' secondes
::: [[File:VoIPms_Ringotel_CreateConnectionSIPPBX_Advanced_AudioCodecs.png|350px]][[File:VoIPms_Ringotel_CreateConnectionSIPPBX_Advanced_Misc.png|350px]]
:4. Save the connection.

----

== 4. Add Users ==
:1. Navigate to '''Users''' inside your organization.
:2. Click '''Add User'''.
:3. Provide:
::* Name
::* Email (for onboarding instructions)
::* Assigned Connection (if multiple connections are created)
::* SIP credentials (auto-filled when PBX integration is active)
:4. Save the user to automatically generate onboarding links.

----

= VoIP.ms SMS/MMS Integration with Ringotel =
:This section describes how you can enable the '''SMS and MMS messaging''' for your DID numbers using '''Ringotel'''.
:Once configured, SMS and MMS messages sent to your VoIP.ms DID can be sent and received directly from Ringotel applications.

== Overview ==
VoIP.ms supports SMS and MMS on compatible DID numbers. By integrating VoIP.ms with Ringotel, you can:
:* Send and receive SMS/MMS using VoIP.ms DID numbers
:* Assign numbers to individual users or teams
:* Manage conversations from desktop and mobile applications

<div style="margin-left:50px;
padding:5px;
border-left: 6px solid rgb(208, 149, 45, 0.8);
box-shadow: 8px 6px 9px -2px #f2f2f2;
background-color: rgba(208, 144, 45, 0.08);
width:70vw;">

🔐 '''IMPORTANT''' ⚠️
: : '''Note:''' SMS via integrations requires the '''Ringotel Pro''' plan.
</div>

== Prerequisites ==
Before starting, ensure you have:
* An active '''VoIP.ms account'''
* One or more '''SMS-capable DID numbers'''
* An active '''Ringotel organization''' with Pro features enabled
* Administrator access to both VoIP.ms and Ringotel

== Enable SMS Integration in Ringotel ==

# Log in to the '''Ringotel Admin Portal'''
# Open your organization
# Navigate to '''Features'''
# Enable '''SMS via Integrations'''
# Save changes
# Open the '''Integrations''' tab
# Select '''VoIP.ms''' and click '''Set up Integration'''
# Copy the '''Webhook URL''' (required for VoIP.ms configuration)

== Configure the DID Number in VoIP.ms ==

=== Enable SMS/MMS on the DID ===

# Log in to the '''VoIP.ms customer portal'''
# Go to '''DID Numbers → Manage DID(s)'''
# Select the DID number and click '''Edit'''
# Under '''Message Service (SMS/MMS)''':
## Enable '''SMS/MMS'''
# Enable '''SMS/MMS URL Callback'''
# Paste the Ringotel Webhook URL and append the following parameters:

<div style="margin-left:50px;
padding:5px;
font-family: Consolas, Monaco, Lucida Console, Liberation Mono, DejaVu Sans Mono, Bitstream Vera Sans Mono, Courier New, monospace;
color: silver;
border-left: 6px solid rgb(208, 56, 45, 0.8);
box-shadow: 8px 6px 9px -2px #f2f2f2;
background-color: black;
width:58%;">

: <nowiki>https://shell.ringotel.co/services/Voipms/aXXXXXXXXXXXXXXXXXXXX?id={ID}&to={TO}&from={FROM}&message={MESSAGE}&files={MEDIA}</nowiki>

: The final URL should look similar to the following:
: <nowiki>https://shell.ringotel.co/services/Voipms/a15945585810414401989?id={ID}&to={TO}&from={FROM}&message={MESSAGE}&files={MEDIA}</nowiki>

</div>

: 7. Save the DID settings

== Enable VoIP.ms API Access ==
Ringotel communicates with VoIP.ms using the VoIP.ms API.

:1. In the VoIP.ms portal, navigate to '''Main Menu → SOAP and REST/JSON API'''
:: [[File:VOIPMS_Main_Menu_RestJsonAPI.png|500px|none]]

:2. Set an '''API Password'''
:3. Enable the API if it is not already enabled
:4. Under '''Enable IP Addresses''', add the following Ringotel IP addresses:

<div style="margin-left:50px;
padding:5px;
font-family: Consolas, Monaco, Lucida Console, Liberation Mono, DejaVu Sans Mono, Bitstream Vera Sans Mono, Courier New, monospace;
color: silver;
border-left: 6px solid rgb(208, 56, 45, 0.8);
box-shadow: 8px 6px 9px -2px #f2f2f2;
background-color: black;
width:58%;">

: 54.145.196.146, 18.130.161.112, 3.0.222.77

</div>
:5. Save the API settings

:: [[File:VOIPMS_API_Ringotel-IPs.png|500px|none]]

== Complete the Integration in Ringotel ==
:After setting up your API password and the IP addresses in your VoIP.ms portal, return to your Ringotel Admin portal to complete the connection.
:## Your '''VoIP.ms login email'''
:## Your '''VoIP.ms API password'''
:# Click '''Save & Continue'''

:: [[File:VoIPms_Ringotel_CreateConnectionSIPTrunk.png|500px|none]]

== Add SMS Numbers and Assign Users ==
# Add your VoIP.ms DID numbers with SMS enabled
# Assign users who can send and receive messages
# Enter phone numbers in '''national format''' (for example, <code>5033889028</code> for US/Canada)
# Configure optional settings:
## '''Session stickiness''' (keeps conversations assigned to the same user)
## '''Number reformatting''' (prevents duplicate conversation threads)
## '''Sender name in messages'''
## '''Auto-replies''' and opt-out messages
# Save the configuration

Users may need to '''log out and log back in''' to access SMS features.

== Notes and Limitations ==

<div style="margin-left:50px;
padding:5px;
border-left: 6px solid rgb(208, 56, 45, 0.8);
box-shadow: 8px 6px 9px -2px #f2f2f2;
background-color: rgba(51, 51, 51, 0.08);
width:70vw;">

⚠️ '''LIMITATIONS'''
: ➜ SMS and MMS availability depends on the DID type and country
: ➜ MMS support may vary by carrier
: ➜ Short codes and toll-free numbers may require additional configuration

</div>