FAQ
Here you will find detailed answers all about fonella, from setup to phone numbers and SIP connection through to costs and data protection. For contractual and data protection details, see also our Terms and Privacy Policy.
What is fonella and how does it work?
fonella is an AI-powered phone assistant that answers incoming calls for your company, in natural language, around the clock. The assistant answers questions about opening hours, services, prices and more, based on the information you store in your customer portal. This way callers are served competently right away, without you or your team having to pick up the phone. Think of fonella as your personal receptionist who never gets sick, never takes a break and is always friendly.
Who is fonella suitable for?
fonella is aimed at small and medium-sized businesses, freelancers, medical practices, trade businesses, law firms, agencies and anyone who wants to be reachable by phone, even outside business hours or when all lines are busy. Whether you receive 5 or 50 calls a day: fonella scales with your needs and ensures that no call is lost any more. Companies that currently miss calls, or whose staff are tied up on the phone with recurring standard questions, benefit in particular.
In which countries is fonella available and how does the country selection work?
During registration you set your account country once. fonella is currently available in the following countries:
- Germany
- USA
- Greece
- Turkey
- United Arab Emirates
This choice is binding and can no longer be changed once setup is complete. The selected country determines three things at once: the currency and prices of your subscription, the billing and the country of your phone numbers. You therefore receive phone numbers with the country code of the chosen country, for example German numbers if you choose Germany.
Independently of this is the display language of the interface: you can change it at any time in the settings without affecting your account country or your phone numbers.
Why can't the country be changed later? Because currency, tax and billing as well as the entire phone number pool depend on it. If you want to use fonella for another country, please create a separate account with the relevant country or contact our support.
Do I get my own phone number?
Yes! During setup you receive your own German phone number from us, free of charge and ready to use immediately. You do not have to apply for anything, conclude contracts with phone providers or have any technical prior knowledge. The number is automatically assigned to your assistant. When a customer calls this number, your AI assistant answers immediately. You can use this number on your website, business card or in your Google listing, or you can set up forwarding from your existing number (see the next question).
Can I continue to use my existing phone number?
Of course. If you would like calls to your existing business number to be answered by fonella, simply set up call forwarding with your phone provider. This takes just a few minutes and works with any provider, whether mobile or landline. You then forward calls to your fonella number either always, when not answered or when the line is busy. This way you keep your familiar number and still benefit from AI call handling.
How do I set up call forwarding?
The setup works with all German providers via standardised GSM codes that you simply enter in your phone’s dialler app and then press “Call”. Replace [your number] with your phone number (e.g. +4930123456789):
Forward all calls immediately:**21*[Your number]# (Deactivate: ##21#)
Only when not answered (after X seconds):**61*[Your number]**20# (Deactivate: ##61#)
The 20 stands for 20 seconds of ringing time, you can choose between 5 and 30 seconds.
Only when the line is busy:**67*[Your number]# (Deactivate: ##67#)
When unreachable (phone off / no network):**62*[Your number]# (Deactivate: ##62#)
Delete all forwarding at once:##002#
These codes work with Telekom, Vodafone, O2, 1&1, congstar and all other German providers, both on mobile and landline. Alternatively, you can also set up forwarding via the respective provider app (MeinMagenta, MeinVodafone, Mein O2) or the online customer centre.
Call forwarding on a landline, how does that work?
For landline connections (e.g. Telekom, Vodafone DSL, Fritz!Box) use the following key codes on your phone:
Immediate forwarding: *21*[Your number]#
When not answered: *61*[Your number]#
When busy: *67*[Your number]#
Deactivate: #21#, #61# or #67#
If you use a Fritz!Box or another VoIP-capable phone system, you can also conveniently set up forwarding via your router’s web interface. In the Fritz!Box you will find the option under Telephony → Call handling → Call forwarding.
What do I need technically to use fonella?
Basically nothing special. All you need is a fonella account and an active subscription. After registration, we guide you step by step through the setup: you describe your company, upload relevant documents if applicable, and your assistant is ready within a few minutes. You receive your own phone number from us, free of charge and without paperwork. Optionally, you can set up call forwarding from your existing number or connect your own SIP trunk if you operate a professional phone system.
Can I connect fonella to my phone system (PBX)?
Yes. If you already operate an IP phone system (e.g. 3CX, Asterisk, innovaphone, Starface or a cloud PBX), you can integrate fonella directly via SIP trunk. This way, calls that your system cannot handle itself (e.g. outside business hours or during overflow) automatically reach your AI assistant. You will find the SIP credentials and configuration options in the customer portal under “Settings → Integrations”. Our support team will be happy to help you with the setup.
How intelligent is the assistant? Does it understand complex questions?
The fonella assistant is based on state-of-the-art language AI and understands natural language, including colloquial phrasing, dialects and more complex sentence structures. It can ask follow-up questions, retrieve information from the documents you have stored and forward or qualify callers in a targeted way. The more relevant information you store in the knowledge base (e.g. price lists, opening hours, frequently asked questions, process descriptions), the more competently your assistant answers. You can try out the assistant at any time using the “Test call” button in the customer portal and experience its conversation behaviour live.
Can I personalise the assistant?
Absolutely. You choose a voice from several natural-sounding options (male and female), define the greeting and can store additional instructions, for example “Always ask for the name”, “Only schedule appointments in the morning” or “For complaints, always refer to the email address”. In addition, you can upload documents (PDF, Word, text, etc.) to the knowledge base, which the assistant automatically uses as a source of information. This way fonella adapts perfectly to your company and your processes.
What is the pronunciation dictionary?
Under Settings → Pronunciation you define how the assistant reads out certain words, e.g. company names, places or technical terms. In the Text column the term appears exactly as it occurs in the conversation; under Read as, the form the voice should use for it. Changes are only applied when you click Save changes in the Pronunciation tab, not when saving other settings.
You will work most reliably with the International Phonetic Alphabet (IPA): first capture the desired pronunciation in IPA (e.g. look it up in Wiktionary or use an IPA generator), then enter a clear phonetic spelling under Read as that matches this pronunciation, the voice reads this entry out literally. The Text must match exactly (upper/lower case, with or without spaces); if the assistant deviates (e.g. “Musterfirma” instead of “Muster Firma”), create a separate line for it. Short, clearly audible phonetic spellings usually work better than long word chains.
After saving, be sure to use “Test assistant” and have the term spoken, this way you immediately hear whether the rule takes effect and can fine-tune the phonetic spelling if necessary. Email addresses and domains (e.g. “at” and “dot”) are controlled via the assistant instructions, not via the dictionary.
Can I test fonella beforehand?
Yes. In the customer portal you will find the “Test assistant” function directly in the top navigation bar. With it you make a test call via your browser and can hear live how your assistant sounds, how it reacts to questions and whether the stored information is reproduced correctly. This way you can check and optimise everything at your leisure before you switch over your production phone number. There are no additional costs for test calls.
How much does fonella cost?
fonella offers various plans based on the number of conversation minutes included. All plans include a free phone number, the full range of features and an unlimited number of test calls. You will find the current prices and plan details on our subscription page. There are no hidden costs, no setup fees and no minimum term, you can cancel monthly.
Are conversations recorded?
Conversations are processed to enable the assistant to respond in real time. Details on storage, processing and your rights regarding the voice and conversation data can be found in our Privacy Policy. Call logs (summaries of the conversations) are available to you in the customer portal under “Call logs”, so that you can see who called and what was discussed. If you have special requirements regarding recording or deletion periods, please feel free to get in touch.
How am I notified of new calls?
After each call you receive an email with a summary of the conversation by default. In addition, you can activate push notifications for individual devices in the customer portal under Account → Push Notifications, for example in the browser (PWA) or in our native apps.
Note on the browser: Push in the web browser depends on your browser and operating system. Apple, Google, Mozilla and other manufacturers impose technical limits (background operation, sleep mode, permissions, installed PWA). On iPhone and iPad an additional Apple requirement applies: push only works there in the Fonella app added to the home screen, not in a normal Safari tab, see the next question for details. For this reason, push notifications in the browser are not always reliable, they may arrive with a delay or not at all, without fonella having failed to process the call (email and call log continue to work).
If you want the most reliable push notifications possible, we recommend the native fonella apps for iOS, Android, Windows and Mac. There we use the respective system push services and usually achieve a significantly higher delivery rate than in the browser.
How do I install the fonella customer portal as an app (PWA)?
You can use the customer portal like an app on your device, without an app store. Here’s how:
iPhone / iPad (Safari):
- Open fonella.ai/kundenbereich in Safari and sign in.
- Tap the share icon at the bottom (square with an upward arrow).
- Choose “Add to Home Screen” and confirm with “Add”.
- From now on, start fonella via the icon on the home screen.
Android (Chrome):
- Open the customer portal in Chrome.
- Tap the menu (⋮) → “Install app” or “Add to home screen”.
- Confirm the installation.
Computer (Chrome, Edge): An install icon (⊕) often appears in the address bar. Alternatively: browser menu → “Install app” or “Install as app”.
Push notifications on the iPhone only work in this installed app, not in a normal Safari tab, see the next question.
Push notifications on iPhone and iPad (Safari), what do I need to be aware of?
On iPhone and iPad, Apple only allows web push for web apps that you have added to the home screen, not when you open the customer portal only in a normal Safari tab with an address bar. This is a system restriction by Apple (from iOS/iPadOS 16.4), not a limitation of fonella alone.
How to activate push on the iPhone:
- Open the customer portal in Safari and tap the share icon → “Add to Home Screen”.
- Then start fonella via the icon on the home screen, not again via a bookmark link in Safari.
- Sign in and go to Account → Push Notifications. Tap “Activate push notifications” and allow notifications when iOS asks.
- If necessary, check under Settings → Notifications → Fonella that notifications are allowed.
If the button is greyed out, this is usually because you are still in the Safari browser and not in the installed app, or because your device is older than iOS 16.4. The email notification after each call works in any case.
For the most reliable delivery on Apple devices, we recommend, as above, the native fonella app for iOS as soon as it is available to you.
How secure is my data?
Data protection is our highest priority. All data is transmitted encrypted and stored on European servers. We process your data exclusively to provide the service and do not pass it on to unauthorised third parties. Processing is GDPR-compliant. In the customer portal under “Account → Privacy” you can request data access or have your account completely deleted at any time. Further details can be found in our Privacy Policy.
Why was my registration or request blocked?
To protect all users from spam and abuse, we automatically check the reputation of the IP address used for every registration, contact request or booking. Requests from IP addresses with a poor reputation, for example known spam sources or addresses flagged for abuse, are rejected.
We also block requests from the Tor network and from VPN services, as these are frequently used to disguise automated or fraudulent activity.
If you receive an error during registration, please disable your VPN and submit the request again over your normal internet connection. In most cases the registration then goes through without any problem.
How do you protect phone numbers against misuse?
Phone numbers entered during registration or in a request are validated and checked against our spam protection measures. We reject numbers that are invalid, that come from known spam ranges, or that show a pattern of abusive use. This keeps our service clean and ensures that genuine customers reach us reliably. If a valid number of yours is wrongly rejected, please contact our support.
How do you protect against spam email addresses?
Every email address is checked by our spam protection measures. We block disposable and throwaway addresses, addresses from domains with a poor reputation, and addresses that show signs of automated or abusive sign-ups. Please use a regular, permanently used email address when registering. If a legitimate address of yours is rejected, our support team will be happy to help.
What happens if the assistant cannot answer a question?
If your assistant reaches its limits, for example with very individual concerns or when information is not stored in the knowledge base, it can tell the caller that a callback will follow, give an email address or end the conversation according to your instructions. In the call log you then see exactly which question was asked, so that you can call the customer back in a targeted way. The more information you store, the less often this happens.
Can the assistant forward calls?
Yes. In the assistant configuration, enter your phone number in the “Company data” tab and set call forwarding to “Allow forwarding”. If a caller wants to speak to a person or your assistant cannot help, it transfers the call straight to this number, for example to you or your front desk. If callers should reach sales, accounting or a specific person directly, add forwarding targets as well, as described in the next question. Both work at the same time.
Can my assistant connect callers to the right department?
Yes. With forwarding targets, every call lands exactly where it belongs. If a caller says “I would like to speak to sales”, your assistant connects them straight to your sales team. If it is about an invoice, the call goes to accounting. Your business sounds like a perfectly organised switchboard, and nobody has to pass calls around by hand.
How to set it up: open the assistant configuration in your customer area and choose the “Forwarding targets” tab.
- Click “Add forwarding target”.
- Enter a name and the target phone number in international format, for example +49301234567. The department is optional.
- Under “Description for the AI”, describe when your assistant should connect there, for example: questions about quotes, prices and new orders. The clearer the description, the more accurate the transfer.
- Save. Your assistant knows the new target right away.
Use “Settings” to change a target at any time and “Remove” to delete it after a safety prompt. The targets apply to the assistant you are editing, so every additional assistant can have its own.
The existing forwarding number in your company data stays in place. It remains the general number for emergencies and for anything your assistant cannot help with. Forwarding targets add dedicated contacts on top, and both work at the same time.
How do I set up my assistant?
After registration and choosing a plan, our setup assistant guides you step by step through the process. You enter your company data (name, industry, contact details), choose a voice and formulate the greeting. Optionally, you can upload documents to the knowledge base. The entire process usually takes 5-10 minutes. After that, your assistant is ready to use immediately. You can adjust all settings at any time in the Assistant configuration.
Can I use my own voice (custom voice ID)?
Yes. If you are on a Premium plan or have a trial/free access (admins too), open the Assistant configuration and choose “Custom voice” under “Voice”. The easiest way is to record 1-3 minutes of audio right there or upload a recording, we automatically create your AI voice from it, with no ElevenLabs account of your own. Alternatively you can paste an existing ElevenLabs voice ID (see below).
For fonella to use your voice, it must be available in the public ElevenLabs Voice Library. In your ElevenLabs account, create a voice, share it to the Voice Library and copy its voice ID (e.g. “zKHQdbB8oaQ7roNTiDTK”). Paste this ID into the “Custom voice” field and save.
Then test your assistant live to check the voice. If your voice is ever unavailable, fonella automatically switches to a configured fallback voice so calls don't break.
Important: Voice cloning and provisioning are performed by the third-party provider ElevenLabs, not by fonella. You are solely responsible for holding the required rights and consents and for ensuring the use, in particular voice cloning, is permitted in your country. See our Terms for details.
Which calendar services does fonella work with?
fonella connects to all common calendar and booking services. Your assistant then checks your availability live during the call and books appointments directly. Currently supported are:
- fonella Calendar: built right into fonella, no external account needed. Create appointments, block time and add everything to your calendar app via a subscription link.
- Google Calendar, via one-click sign-in (OAuth), with no extra software.
- Microsoft 365 / Outlook, also via one-click sign-in (OAuth) using your Microsoft account.
- Apple / iCloud Calendar, via the open CalDAV protocol with an app-specific password (see the next question).
- Generic CalDAV calendars, e.g. Nextcloud, Fastmail or mailbox.org, and many more.
- Calendly, connected as a booking tool, including importing your existing event types.
- Cal.com, the open-source booking platform, also via one-click sign-in.
What makes this special: fonella is the first AI phone assistant to integrate Microsoft and Google calendars natively, with our own calendar integrations built directly into fonella. You don't need any intermediary services, Zapier bridges or third-party tools: the connection runs directly between fonella and your calendar, which is faster, more reliable and more data-efficient.
You connect and manage all calendars in the customer portal under „Appointments → Integrations“.
How does the assistant book appointments during a call?
As soon as a calendar is connected, your assistant can arrange appointments on its own during the conversation. It recognizes the caller's request, checks in real time which times are free for you, suggests suitable slots and writes the agreed appointment directly into your calendar, including the caller's name, concern and contact details, where available.
You set the rules yourself: appointment duration, buffer times between appointments, lead time as well as bookable time windows (e.g. only weekdays 9am-5pm) and which calendar is used for new bookings. This way the assistant only books appointments that genuinely fit into your working day.
Note: You can see the booked appointment immediately in your connected calendar and in the customer portal under „Appointments“.
Can fonella take availability from several calendars into account?
Yes. You can connect several calendars at the same time, for example your business Google calendar and a private iCloud calendar. fonella merges the free/busy times of all connected calendars and only suggests times that are free in all calendars. This prevents double bookings across different accounts.
For new bookings you pick one calendar as the target; all other calendars continue to be used for the availability check. If an appointment changes externally (e.g. a cancellation made directly in Outlook), fonella detects this automatically and frees the slot again.
How secure is the calendar connection and which data is read?
The connection is made through the official interfaces provided by Google, Microsoft and others. fonella only requests the minimum permissions required, essentially reading your free/busy times and creating appointments. The contents of other appointments, such as titles, participants or notes, are not needed for the pure availability check.
Your access credentials are stored encrypted, and you can disconnect any calendar connection at any time in the customer portal under „Appointments → Integrations“. Access ends immediately.
How do I connect my Apple/iCloud calendar?
Unlike Google and Microsoft, Apple does not offer a one-click sign-in (OAuth) for iCloud calendars. The connection therefore uses the standard CalDAV protocol with an app-specific password. It sounds technical, but it only takes a few minutes:
Step by step:
- Sign in at appleid.apple.com with your Apple ID.
- Open the “Sign-In & Security” section and select “App-Specific Passwords”.
- Create a new app-specific password (e.g. named “Fonella”) and copy the password shown.
- In fonella, open Appointments → Integrations and click “Connect” next to “CalDAV”.
- Enter
https://caldav.icloud.comas the CalDAV URL, your Apple ID (email address) as the username, and the app-specific password you just created as the password. - Click “Connect”, done. Your iCloud availability and bookings are now synchronized.
Important: Do not use your normal Apple ID password, because of two-factor authentication, only an app-specific password works. You can disconnect at any time.
Why are only a few appointments booked via Calendly (limit reached)?
On its free trial tier, Calendly limits automated booking through its interface (Scheduling API) to 5 bookings per 24 hours (as of today). Once that quota is used up, Calendly temporarily rejects further bookings and your assistant can't record the appointment until the limit resets. This is a Calendly restriction, not a fault in fonella.
For unlimited or significantly higher booking volume, upgrade your Calendly plan to a paid tier (Standard or higher) at calendly.com/pricing. After that, appointment booking via Calendly runs smoothly and without a daily limit.
Note: The limit only affects automated Calendly booking on the trial. Alternatively, under Appointments → Integrations you can connect a different calendar such as cal.com or a CalDAV calendar (e.g. Apple/iCloud), which works without this daily limit.
What happens in the event of technical faults?
Should a technical fault ever occur, we recommend setting up a fallback forwarding with your phone provider, for example to your voicemail or a mobile number. This way no calls are lost even in exceptional cases. fonella is continuously monitored and we inform you in good time about planned maintenance work. For acute problems you can reach our support team at any time by email.
What are additional assistants for?
With additional assistants you book further assistants next to your main assistant, each for 9,99 € per month. Every additional assistant has its own settings: own voice, greeting, knowledge base, instructions and, if applicable, SIP connection. From the Starter plan on, each assistant comes with its own phone number; on the Messenger plan it works over the chat channels without a number. In the customer portal you switch between your assistants at the top of the bar and configure each one separately.
The included minutes and messages of your subscription apply jointly to all assistants: calls and chats with the main and the additional assistants share the same allowance. There are no separate allowances per assistant.
Typical use cases:
- Multiple languages: e.g. one assistant in German and a second with English-speaking service, ideal if you want to serve customers in different languages.
- Multiple companies or brands: You manage different businesses or projects under one account, each with its own assistant and, from Starter on, its own phone number.
- Separate entry points: e.g. reception and emergency service, or different locations: each assistant with its own profile, without having to take out a second main subscription.
You book and manage additional assistants in the customer portal under “Subscription” or directly via the assistant menu at the top of the navigation bar.
How do I embed the chat widget on a multilingual website?
One embed code covers every language of your website. Without further settings, the widget follows the language your page declares in the lang attribute of its html element.
If a page should set the language explicitly, add a data attribute to the embed code from your customer area under “Settings → Chat widget”. On the English version of your site, for example, you add data-language="en":
<script src="https://www.fonella.ai/chat-widget.js" data-key="YOUR-WIDGET-KEY" data-language="en" async></script>data-languagesets both languages at once, the widget labels and the language the assistant answers in.data-ui-languagesets only the widget labels, meaning buttons, input field and notices. Available are German, English, Turkish, Arabic, Greek, Spanish, French and Russian.data-assistant-languagesets only the language the assistant answers in.
The attributes take precedence over the language settings in your customer area. Pages without an attribute keep using what you set there.
How do I connect Telegram to my assistant?
For Telegram you create your own bot. Your assistant then answers every private message sent to this bot. It only takes a few minutes:
- Open Telegram and search for @BotFather. This is Telegram’s official bot, marked with a blue check mark.
- Tap “Start” and send the command
/newbot. - Enter a display name, for example the name of your business. Your customers see this name in the chat.
- Choose a username for the bot. It has to end in “bot”, for example
examplecompany_bot. - BotFather sends you a message with the bot token, a long string like
123456789:AAH…. Copy this token completely. - In your customer area, open “Settings → Integrations” and, under Chat channels, click “Connect” next to Telegram.
- Paste the token into the “Bot token” field and confirm with “Connect”.
From now on your assistant answers messages sent to your bot. You can share the link to your bot, t.me/ followed by its username, on your website, in your email signature or on business cards.
Treat the token like a password: whoever knows it can control your bot. If it has fallen into the wrong hands, create a new token with /revoke in BotFather and connect Telegram again with it.
How do I connect a mailbox to my assistant?
Your assistant can answer incoming emails. To do so, you connect your mailbox by IMAP and SMTP. It takes a few minutes:
- In the assistant configuration, open the Integration tab and go to the Email mailboxes section.
- Click "Add mailbox" and enter the email address and display name.
- Enter the IMAP server for incoming mail, usually
imap.your-domain.comwith port993and SSL/TLS, plus user and password. - Enter the SMTP server for outgoing mail, usually
smtp.your-domain.comwith port587and STARTTLS or port465and SSL/TLS. - Click "Save and check". fonella tests both logins before the mailbox is saved.
Your assistant then answers new emails in the same thread, with your signature. Older emails stay untouched. You can connect as many mailboxes as you like.
Passwords are stored encrypted and never shown again. If your provider uses two-factor sign-in, create an app password and enter that.
How does the address book work?
In the address book you store your contacts with salutation, name, company, phone numbers, e-mail addresses, messenger handles, address and notes. For each contact you decide whether the assistant addresses them formally or informally.
When a contact writes from a stored e-mail address, WhatsApp number or messenger handle, the assistant recognises them automatically and greets them personally, for example "Hello Mr Peters" or, informally, "Hi Petra". On the phone the assistant greets as usual; after the call the summary goes into the logbook of the contact with that phone number.
The assistant only ever sees the contact who is writing right now. It never searches the address book on request and never gives out data of other contacts.
After every conversation the assistant writes a summary into the contact's logbook, and you can add your own notes. At the next contact with exactly this person the assistant knows what was discussed.
Under Integrations you bring in contacts from Apple iCloud or a CardDAV server, or upload a vCard or CSV file, for example the export from Google Contacts.
How do I set up the chat widget?
In the chat widget section you set everything up and save it with one click. The basic settings suit most websites, so you can start right away.
- Add it to your website: Copy the embed code and paste it into your website, or pass it on to your web agency. The chat icon then appears on your site.
- Appearance: Adjust colours, icon, position, font and font size to match your website.
- Welcome message: The first message visitors read in the chat window. If you leave the field empty, the assistant uses its standard greeting.
- Assistant language: The assistant replies in this language. If you like, it replies in the language the visitor writes in.
- Marketing message: A short line next to the closed chat icon, for example “Any questions? Write to us.” You decide how often it appears.
- Open automatically: If you like, the chat window opens by itself after a few seconds.
- Keep history: Decides whether visitors see their chat only in the current tab or also on their next visit.
- Hide on paths: List the pages where the chat widget should not appear, for example your checkout.
The remaining fields under Advanced settings are meant for special wishes. If you leave them unchanged, the chat widget still works and looks good.
A chat ends as soon as the visitor leaves your website, writes nothing for five minutes or starts a new chat. Shortly afterwards it appears in your logs and you receive the summary by email.
WhatsApp Business, Instagram, Facebook and Telegram have their own Advanced settings with welcome message and language under Chat channels in Integrations. Colours and appearance only affect the chat widget on your website.
By default, you connect WhatsApp Business through the official Meta interface. On request, we can also support regular WhatsApp without a business account, just get in touch with us.
Why does the assistant stop replying in a chat after I wrote there myself?
When you write in a customer chat yourself, by text or voice message, you take over that chat. The assistant then pauses in that one chat for four hours so it does not talk over you. It keeps answering all other chats as usual.
The four hours count from your last own message in that chat. If you write again, they start over. After that the assistant replies there again on its own, you do not need to do anything.
If you want it to take over again right away, disconnect the channel under Chat channels in the customer area at “Settings → Integrations” and connect it again. The new connection ends any running pause. The chat widget on your website has no such pause.
How do I get the most out of WhatsApp and the other chat channels?
Turn off the notifications of the messenger app itself and let the assistant take over the messages completely. It then replies right away and you are not interrupted by every message. We report what matters in a summary.
Connections to messengers such as WhatsApp are occasionally closed by the provider, this can happen every one to two weeks. No need to worry: you then immediately receive an email and a push message that the channel has to be reconnected. It takes a few seconds in the customer area at “Settings → Integrations”. If you disconnect a channel yourself, you do not get this message.
What developer features does fonella offer?
fonella is far more than a calling assistant: in the customer portal under “Developers” you have three coordinated interfaces at your disposal that let you embed fonella deeply into your own system landscape. First, a full REST API through which you can programmatically retrieve call logs, transcripts and call summaries and manage your settings in an automated way. Second, webhooks that notify your systems in real time as soon as a call starts, ends or a summary becomes available, without you having to poll regularly. And third, custom tools that allow the AI to call your own HTTP endpoints during a live conversation, for example to look up customer data or book appointments. All three building blocks can be used individually or in combination and are designed so that even small teams without a large development department reach results quickly. To get started, you will find ready-made code examples in several programming languages for each area directly in the customer portal. This turns fonella from a mere answering machine into an integral part of your digital processes.
How do I get access to the fonella API?
You manage API access yourself via the customer portal under “Developers → API Keys”. There you create a new key in just a few clicks, give it a descriptive name (e.g. “CRM integration” or “Reporting”) and immediately receive your personal token in the format fon_live_…. Important: for security reasons this token is shown in full only once, copy it right away and keep it in a safe place, for example in a password manager or in your application's environment variables. After that you send all requests to the base URL https://api.fonella.ai and pass the key in the HTTP header “Authorization: Bearer fon_live_…”. You can run up to ten keys per account at the same time, so you can use separate credentials for different applications or environments and revoke individual keys at any time without disrupting other integrations. If a key is ever compromised, simply delete it, from that moment on, all requests using that token are immediately rejected. This way you always retain full control over which systems may access your data.
How do I connect fonella to Claude or ChatGPT (MCP)?
With the fonella MCP server you set up your assistant straight from Claude, ChatGPT or another AI tool: create tools, connect webhooks to your system, change settings, read calls and chats. The server address is https://api.fonella.ai/mcp. You sign in with your fonella account, no separate application or API key is needed.
- Claude: Under Settings, Connectors, choose “Add custom connector”, enter the address and sign in with your fonella account.
- ChatGPT: Under Settings, Apps and Connectors, create a new connector in developer mode, enter the address, choose OAuth as authentication and sign in with your fonella account.
- Other AI tools: Any AI tool that supports remote MCP servers with OAuth, such as Cursor, works with the same address.
Access is included in the Business and Premium plans. It acts with your permissions and only on the data of your own account.
Anything that costs money, such as changing or cancelling the plan or booking extra numbers and assistants, and deleting the account are only possible in the customer area. The MCP server gives you the link.
What can I automate with the REST API?
The REST API gives you programmatic access to exactly the data that is otherwise only visible in the customer portal, above all your call logs. Using the /v1/calls endpoint you retrieve the list of your calls, and with /v1/calls/{callId} you receive the details of each individual call including the full transcript and the automatically generated summary. This lets you automate numerous workflows: you can import new calls into your own dashboard or BI tool, mirror call data into a database or data warehouse, build reports on call volume and topics, or pass leads directly to sales and marketing. In addition, the API also lets you manage your webhooks, custom tools and other API keys, so even setting up your integration can be fully scripted. Because the interface follows a clear, resource-oriented REST schema and returns structured JSON, connecting it is straightforward in any common programming language. This turns the conversation data generated in fonella into an automated stream that flows seamlessly into your existing processes, without manual copying and without media breaks.
What are webhooks and which events are available?
Webhooks are the counterpart to actively polling the API: instead of repeatedly asking whether something new has happened, you register your own URL, and fonella automatically sends an HTTP message to exactly that address as soon as a relevant event occurs. This gives your systems information in real time, ideal for processing calls immediately, notifying staff, or instantly syncing data with other tools. You can select per endpoint precisely which events interest you: available options include call.started (a call begins), call.ended (a call has ended), call.failed (a call has failed), call.transcript and call.speech_update (transcript and ongoing speech updates respectively), call.tool_call (the AI invokes a tool), call.hang and call.summary (the finished call summary is available). Webhooks are set up and managed conveniently in the customer portal under “Developers → Webhooks”, where for each endpoint you define a name, target URL, a description and the subscribed events. You can run several webhooks in parallel, for example one for your CRM and another for internal monitoring, and configure each of them independently. This lets you build event-driven workflows that react without delay and without manual intervention.
How do I make sure webhooks really come from fonella?
Because a webhook endpoint is generally reachable from the internet, you should verify every incoming message before trusting it. fonella therefore signs every webhook delivery using an HMAC-SHA-256 process and places the result in the HTTP header X-Fonella-Signature. When you create a webhook you receive an associated secret which, like an API key, is shown only once and must be stored securely. In your endpoint you then compute your own HMAC-SHA-256 signature from the received raw payload and this secret, and compare it with the supplied header value. If both match, it is guaranteed that the message actually came from fonella and was not altered in transit; if they differ, you should reject the request. For the comparison we recommend a constant-time function (e.g. hmac.compare_digest in Python or hmac.Equal in Go) to avoid so-called timing attacks. In the customer portal under “Developers → Webhooks” you will find ready-made verification examples in curl, JavaScript, Python, PHP and Go that you can adopt almost unchanged. This way, with just a few lines of code, you ensure that only genuine fonella events trigger actions in your systems.
What are custom tools and what can the AI do with them?
Custom tools are arguably the most powerful developer feature: they allow the assistant to call your own HTTP endpoints during a live phone call and let the result flow directly into the conversation. This means your assistant is no longer limited to statically stored knowledge but can access your real-time data live, for example querying a customer's order status, checking whether a particular appointment is still available, looking up master data from your CRM, or subsequently creating a ticket or a booking. You define a tool in the customer portal under “Developers → Tools” via a name, a meaningful description, the target URL, the HTTP method (GET or POST) and an optional JSON input schema. The description is particularly important, because it is how the AI recognizes exactly when the tool makes sense to use; the input schema defines which parameters it passes. When the tool is triggered during a call, fonella sends the arguments determined by the AI to your endpoint, and your response is passed on by the assistant immediately in natural language to the caller. This creates dynamic, data-driven conversations in which callers receive binding information right away, instead of being put off with a callback.
Can I connect fonella to my CRM, calendar or booking system?
Yes, and that is exactly what the developer features are made for. In practice you combine the three building blocks depending on the use case: Custom tools integrate your CRM, calendar or booking system live into the conversation, so that the assistant can, for example, suggest available appointments, make a booking or state the status of a case while the caller is still on the line. Webhooks ensure that after every call data automatically flows back into your systems, for example a new lead created in HubSpot or Salesforce, a contact updated, or a task created for your team as soon as the call summary is available. And you use the REST API to retrieve, reconcile or feed conversation data into reports afterwards. Typical scenarios you can implement with this include automatic appointment scheduling via your calendar, lead capture with direct handover to sales, information about order or delivery status from your shop system, or the creation of support tickets. Because all interfaces are based on open web standards (HTTPS and JSON), they can be connected to almost any common CRM, calendar or booking tool, either directly or via automation platforms such as Make or Zapier. If you are unsure which approach is right for your case, our support team will gladly help you with the design.
Which programming languages can I integrate with?
Since all of fonella's developer features are based on open web standards, namely HTTPS requests with JSON as the data format, you can in principle use any programming language and any framework that can make HTTP calls. You are therefore not tied to a specific SDK or a particular runtime and can fit fonella seamlessly into your existing technology stack. To make getting started as easy as possible, you will find ready-made, copyable code examples in five widely used languages directly in the customer portal under “Developers” for each area, API keys, webhooks and custom tools: curl (for the command line and quick tests), JavaScript/Node.js, Python, PHP and Go. These examples each show the typical use case, such as retrieving calls via the API, verifying a webhook signature or setting up a tool endpoint, and can usually be adopted directly with minimal adjustments. If you use another language such as Java, C#, Ruby or Rust, the examples serve as a clear template that transfers easily, since the underlying HTTP calls remain identical. This keeps the integration effort manageable even for small teams, regardless of what else you work with.
Do I need a paid plan for the developer features?
The developer features, that is, API keys, webhooks and custom tools, are part of the regular feature set and require an active, paid subscription. As long as no valid subscription is on file for your account, you will indeed see the respective tabs in the developer area, but access to creating keys, webhooks and tools is locked, and a notice with the option to upgrade appears. This coupling to a subscription ensures that the interfaces are only used productively by active customers, while at the same time protecting your data and the stability of the platform. You can perform an upgrade yourself at any time in the customer portal under “Subscription”; immediately after completion, all developer features are available to you without any further activation. There are no separate base fees for using the API itself, the usual billing is handled via the services and call minutes included in your plan. If you have special requirements regarding volume or feature scope, feel free to contact us so that we can find the right plan for your integration project.
How do I test webhooks and custom tools before going live?
Before you switch an integration to production, you can and should try it out safely, fonella provides practical test tools for this directly in the customer portal. For webhooks you will find a “Test” button for each configured endpoint: with it you select a specific event (such as call.summary or call.ended) and trigger the sending of a realistic sample payload to your URL. This lets you check whether your endpoint is reachable, whether the signature is verified correctly, and whether your processing logic handles the data as expected, all without an actual call having to take place. You test custom tools best via the “Test assistant” function in the top navigation bar of the customer portal: with it you carry out a test call directly in the browser and can experience live whether the AI calls your tool at the right moment, which arguments it passes, and how it incorporates your response into the conversation. For developing your endpoint, it is advisable to log incoming requests first, so that you can precisely understand the structure and content of the transmitted data. Only once webhook and tool calls behave reliably in testing should you enable the integration for production use, this way you avoid unpleasant surprises during real customer conversations.
Is there a customer service that helps me with questions?
Of course. Our support team is available for all your questions, whether about the initial setup, the SIP connection, the optimal configuration of your assistant or general questions. You can reach us via the contact form on our home page or by email (see Legal notice). We are also happy to help you set up call forwarding with your provider or configure your SIP trunk.
How do I cancel my subscription?
You can cancel your subscription at any time in the customer portal under “Subscription”, effective at the end of the current billing period. There is no minimum term and no hidden notice periods. After cancellation, your assistant remains active until the end of the paid period. You can have your data exported before deletion (GDPR Art. 15), you will find the option under “Account → Privacy”.