The ChatFlamingo Handbook
Everything you can do in the dashboard, explained step by step: answering chats, feeding the bot with knowledge, setting up actions such as support tickets, and connecting your shop and your tools.
The Android app rings for new chats, even when the phone is locked in your pocket, as long as you are set to Online. Download the Android app (APK, Android 6.0 or later, not on Google Play). The first time, Android asks whether to allow apps from this source. The app tells you about new versions itself. Had version 0.2.0? Uninstall it first: from 0.5.0 on the app is signed with a new key, and Android will not install it over the old one. On the iPhone, install the dashboard as a web app.
How to use this handbook: search for any word at the top right (the / key jumps to the search field). The outline is on the left. Click a picture to see it full size. Paths in the dashboard are written like this: Settings › Chat window › WhatsApp button.
All pictures show the fictional Summit Coffee Roasters with made-up visitors. Your dashboard looks the same, with your name, your colours and your customers.
Getting started
From your first sign-in to the chat on your website. If you went through the setup wizard, most of this is already done.
Signing in
The dashboard lives at the address of your installation with /admin at the end. There are three ways in:
- User name and password: the form below. You can pick the dashboard language right here, under the button.
- Login link by e-mail: after setup you receive a link that signs you in without a password. Set your own password later under Settings › My account.
- Invitation: colleagues receive an e-mail with a button to set their password. They choose it themselves (at least 6 characters) and are then signed in.
Your session survives updates. If you signed in on someone else's computer, use Sign out in the account menu at the top right.
The setup wizard
On first start a wizard takes you to a working chat in a few minutes. It reads your website and suggests everything it needs from there.
- Enter your website address, e.g.
www.your-company.com. - We read your website: products, prices, shipping, service, contact and legal pages become knowledge documents for the bot. Depending on the size this takes one to a few minutes.
- Does this look right? Check the chat's name, colour and face, and change them if needed.
- What should the chat achieve? Tick your goals, such as collecting contacts, selling more or answering questions at once. They shape the bot's answer style.
- Try it: the chat already answers with your knowledge.
- Where does the chat go? Copy the embed line for your website (on Shopify: switch it on in the theme editor).
- Set a password (optional) and go to the dashboard.
The getting-started list
While something is still missing, the settings show the Getting started list with a progress bar. Click an item to go straight to the right card. The items:
| Item | Where it is done |
|---|---|
| Put the chat on your website | Chat window › Put the chat on your website (Shopify: switch it on in the theme editor) |
| Add documents or your website as knowledge | Bot › Sources |
| Check opening hours | Availability › Opening hours for human help |
| Turn on notifications | My account › Notifications on this device |
| Set up e-mail sending | Technical › Email / SMTP server |
| Invite colleagues | Team › Team & accounts |
Once every item is done, the list disappears by itself. You can also hide it earlier.
Dashboard layout
The four areas
| Area | What it is for |
|---|---|
| Chats | All conversations: read along live, take over and reply. The number on the icon counts conversations waiting for a person. |
| Analytics | Figures, busy hours, topics and where visitors come from. |
| Bot | Everything the bot knows and how it answers: Fix answers, Sources, Answer style, Actions, Try it. |
| Settings | My account, Team, Plan, Availability, Chat window, Chat tools, Connections, Technical. |
The status in the top bar
The green or grey pill next to your name shows whether people are available right now: Office open or Outside hours. It follows your opening hours. Click it to override the schedule for a while:
- We are here — 4 h or until tomorrow: requests go to the team, even outside your hours.
- Away briefly — 1 h or Closed — today: visitors are offered the e-mail form straight away.
- Automatic: back to the schedule. “Manual” in the pill shows that availability was set by hand; when the time runs out, the schedule applies again by itself.
The account menu
Click your picture at the top right to open the account menu:
- Sound for new chats: on or off, for this device.
- Language: the dashboard language, independent of the chat language on your website.
- Install app: puts the dashboard on your computer or phone as an app (only when the browser offers it).
- Sign out.
If notifications are still off on this device, a bar below the top bar offers Turn on, Set up and Later.
The app on your phone
The dashboard works fully on a phone. Installed as an app, it delivers notifications even when it is closed.
- Open the dashboard in your phone's browser and sign in.
- Account menu › Install app (iPhone: Share › “Add to Home Screen”).
- Open the app and turn on notifications under Settings › My account.
- Lock the phone, put it down, then press Send test notification. It should arrive within seconds.
The setup assistant
A chat inside the dashboard that sets up the bot with you. Tell it what you need in your own words; it suggests the change, and you confirm.
Open it with ✨ Assistant in the top bar (administrators only). It greets you with “I'll help you set up your bot.” and offers a few starting points. It can:
- Create actions: support tickets, call-backs, quotes and more, based on the templates, with the questions and routes you describe.
- Help with connections: it finds the right service among the more than 90, explains where you get the access details, and opens the connection form for you.
- Change settings: opening hours, special days, support address, widget texts and colours, proactive message, WhatsApp button, canned responses and the house style.
- Add knowledge: it writes a document (an FAQ, shipping terms, prices) from what you tell it and adds it to the knowledge base, and it creates corrections.
- Answer questions about the dashboard: it looks things up in this handbook and tells you where to find them.
- Write what you want, e.g. “Tickets by e-mail to service@my-company.com, and we are open Mon–Fri 8–17.”
- The assistant asks for anything missing and shows each change as a card with a short summary.
- Apply saves it, exactly as if you had set it in the dashboard yourself; Discard drops it. The card then says “Applied”, and the page shows the new state.
Built-in safeguards: nothing is saved without your click, and every change goes through the same checks as the dashboard (an invalid opening time is refused). The assistant never asks for passwords or API keys: you enter those in the form it opens. If a message contains something that looks like a key, it is removed before it reaches the model. Deleting the account, booking a plan and passwords are not handled by the assistant. Its answers do not count towards your answer budget.
Speaking instead of typing
The microphone next to the input field records a voice message: tap it, speak, tap it again (at most two minutes). The note button uploads a voice memo you already have, such as an MP3 or M4A from your phone (up to 25 MB). A moment later the text appears in the input field. Check it, then press Send: dictated e-mail addresses, phone numbers and codes are what speech recognition gets wrong most often, which is why nothing is sent on its own.
The first time, the browser asks for permission to use the microphone. The recording is only converted to text and then discarded; it is not stored. Anything in it that sounds like an access key is removed from the text.
↺ starts a new conversation. The conversation is kept only while the dashboard tab is open.
Chats: read along, take over, reply
The bot answers most questions on its own. You see every conversation live and can take over at any moment.
The inbox
Conversations are listed on the left, newest first. Three tabs filter them:
- Inbox: all ongoing conversations.
- Mine: those assigned to you or taken over by you.
- Archive: finished conversations.
Each row shows the visitor's name (or an ID), the last question, the last answer, the page the visitor is on and the tags. The badge tells you who is answering:
| Badge | Meaning |
|---|---|
| BOT | The bot is answering. |
| NEEDS HELP | The visitor wants a person. The dashboard keeps ringing until someone takes over. |
| LIVE | A team member is answering. |
A green dot in front of the row means the visitor is on your website right now.
Reading a conversation
Click a row to open the conversation with all its messages. Below each bot answer is Fix this answer: it takes you to Corrections with the bot's answer already filled in.
Taking over and replying
- Open the conversation and click Take over at the top right. The bot goes quiet; the visitor sees that a person has joined.
- Type your reply at the bottom and press Send (or Enter; Shift+Enter for a new line).
- Done? Return to bot hands the conversation back.
Replies from your team never cost anything and are never blocked, not even when the answer budget is used up.
Tools in a conversation
These buttons sit at the top of a conversation (on a phone they are in the ⋯ menu):
| Button | What it does |
|---|---|
| Assign | The “Unassigned” menu gives the conversation to a colleague. It then appears under “Mine” for them. |
| ✨ Suggest | The Copilot drafts a reply from the conversation and your knowledge. When on, a draft is written automatically for every conversation you handle. Insert into reply puts it in the reply field; you check it and send it yourself. |
| 🛒 Send product | Type a product (e.g. “espresso 1 kg”) or paste its address, choose a quantity, send. The visitor gets a card with picture, price and “Add to cart”. Needs a connected shop. |
| ✉ Hand over | Writes a summary with contact details and tasks for your internal team. You can edit it, then it goes by e-mail to the support address. |
| ⓘ Visitor details | Shows or hides the right-hand column. |
| ⋯ › Delete conversation | Deletes the conversation with all messages and files, after asking you to confirm. |
Canned responses with “/”
Type / in the reply field and your canned responses appear. Keep typing to filter (/shipping); a click or Enter inserts the text.
Photos and files
The paper clip next to the reply field sends a photo or PDF into the chat. Visitors can send photos too, for example of a type plate; they appear in the conversation.
Handing over to the internal team
Visitor details
Next to the conversation, on the right, is everything known about the visitor:
| Field | Meaning |
|---|---|
| Status | Online or offline. |
| Name, e-mail, phone | What the visitor provided. |
| Shop account | If the customer is signed in to your shop, their account appears here (see Recognise signed-in shop customers). |
| Location, browser, source | Approximate location, device, and where the visit came from (Google, an ad, a link). |
| Language | The bot answers in this language. You can change it here. |
| Rating | The visitor's 👍 or 👎. |
| Translation | “auto” translates both ways: you read your language, the visitor reads theirs. |
- Tags: type one and press Enter, e.g. “quote”. Up to 10 per conversation; the × removes one.
- Shopping cart: what is in the visitor's cart (with a shop connection).
- Current page and Page history: where the visitor is and has been.
- Previous conversations of the same visitor.
- Notes: visible to the team only, kept with the customer.
- Ban visitor: for harassment and spam. The visitor can no longer write.
Live now and contacts
Above the inbox are two more views:
- Live now: everyone currently on your website with the chat loaded. Start chat opens the chat on their screen and connects you directly.
- Contacts: everyone who left a name, e-mail or phone number, grouped across all their conversations. Download as CSV exports the list, for example for your CRM.
Analytics
What is happening in the chat, where visitors come from and what they want to know. Nothing extra is tracked: everything comes from what the conversations already carry.
Overview
| Tile | What it counts |
|---|---|
| Conversations | Conversations in the period. |
| Messages | All messages from visitors, bot and team. |
| Handled by team | Conversations in which a person replied. |
| Tickets | Requests from the e-mail form and from actions. |
| CSAT | Share of 👍 among all ratings, with the number of ratings in brackets. |
| Open missed questions | Questions the bot could not answer (see Missed questions). |
| Live visitors | Who is on the website right now. |
Trend and busiest hours
Conversations — last 30 days shows one bar per day. Busiest hours shows at what time of day visitors write: a good guide for your opening hours.
Where the chats come from
Choose the Period (7 days, 30 days, 90 days, 12 months). The line above sums up: conversations, how many had questions, questions in total, questions per conversation. Below it, one bar chart each with count and share:
- Most asked topics
- Source (ads, search, social, direct)
- Language
- Country
- Place
- Device
- Operating system
- Browser
- Landing page
- Most visited pages
The bot recognises the most asked topics from the questions, in every language. If a topic appears there that none of your documents covers, it is worth adding one.
Links with ?utm_source=flyer (or newsletter, instagram …) appear under “Source” with that name. That way you can see what a flyer brings in.
The bot: knowledge, style, actions
Here you decide what the bot knows, how it sounds and what it may do for visitors. Five tabs, in the order you need them day to day.
The bot answers only from your documents, your website and your corrections. What is not there, it does not make up: it says so and offers the team. Such questions end up under Missed questions.
Fix answers
Missed questions
Questions the bot could not answer from the knowledge base, with how often and when they were asked. The number on the tab shows how many are open.
- Click Answer and write the correct answer once.
- Save. The question and answer go into the knowledge base; from then on the bot answers it itself.
Dismiss removes a question that needs no answer (nonsense, greetings, typos).
Customer feedback
Negative ratings (👎) with the answers to “What went wrong?” and “What could we do better?”. Click an entry to open the conversation.
Corrections
Found a wrong or outdated answer? Write the correction here instead of hunting through the files. Corrections are sent with every bot answer and always win against an old document.
- Under New correction write it short and factual, e.g. “The discount code AUTUMN10 has expired. Do not mention discount codes.”
- Add. It applies immediately.
- Below, under Test the bot, ask the question the way a customer would and check the answer.
Each correction can be paused (Pause, reactivate later) or deleted. Up to 40 corrections, 500 characters each.
Banning a word entirely: add verbiete: WORD to a correction and any sentence containing that word is dropped from the answer. It is a hard filter, so use it sparingly. A word you only mention in a correction stays sayable.
Corrections are for facts that changed. How the bot should sound belongs in the answer style.
Sources
What the bot answers from: your documents, the pages of your website and connected sources such as Google Drive or SharePoint (see Services › Knowledge sources).
Knowledge base documents
- Choose files… and pick one or more files: PDF, Word (DOC, DOCX), PowerPoint (PPTX), Markdown, TXT, HTML, JSON, CSV.
- Upload. The files are searchable a minute or two later.
Good candidates: manuals, FAQs, spare part lists, warranty terms, price lists, shipping terms. Every file in the list can be deleted or replaced with a newer one.
Importing the sitemap: the link directory
So that the bot adds the right link to each answer (e.g. …/support/shipping/), it learns the list of your pages.
- Enter your website address, e.g.
www.your-company.com. The sitemap is found automatically (inrobots.txt, at/sitemap.xmland/sitemap_index.xml). A full sitemap address works too. - Import URL. The sitemap address found is then shown in the field, with the number of pages below it.
- No public sitemap? Use …or upload XML.
- Under Check the saved sitemap automatically choose “daily” or “weekly” and Save. Check now checks right away.
A new import replaces the old directory. The automatic check only uploads again when your page list has actually changed, so a quiet day costs nothing.
Website discovery (beta)
Reads the pages themselves, not just the list, and builds knowledge documents by topic: products, prices and payment, shipping, service and warranty, FAQ, contact, legal. One file per topic appears in the document list.
- Enter the Website address.
- Choose the Page budget (10 to 1000, default 250): the maximum number of pages read.
- Read the website. Reading is polite, four pages at a time; even large shops finish in minutes. The report below shows what was found.
A new run replaces the previous one. This is also where you find Run the setup wizard again.
Answer style
What the chat should achieve
Your goals shape the house style: a bot meant to collect contact details asks for them, a shop bot recommends products.
- Collect contact details (leads)
- More sales in the online shop
- Purchase advice like in a store
- Phone calls and call-backs
- Book consultation appointments
- Take quote requests
- Answer questions at once, relieve the team
Plus: Phone number for calls, Booking link (e.g. Calendly) and an Other goal in one sentence. Suggest house style from these goals puts matching rules into the field below, for you to check; nothing is saved until you click.
How the bot should answer (house style)
One rule per line. The rules are sent with every bot answer and every Copilot draft. Write how your company speaks: tone, length, what the bot should ask before it recommends something. Examples:
- Keep answers short, three sentences at most.
- Address customers formally.
- Before recommending a coffee, ask how the customer brews.
Save house style or Reset to factory. The counter below shows how long the rules are.
Built-in system prompt
The fixed rules every answer is built on: core rules, order status rules (with and without a shop connection) and product card rules. Placeholders: {brand} becomes your brand name, {langHint} the automatic language hint, {abilities} what this installation can really do.
Change these only if you know what you are doing: a careless change alters the bot's core behaviour. An empty field and Reset to factory restore the original text.
Actions: what the bot may do
With actions, the bot creates a support ticket, arranges a call-back or takes a quote request by itself. It recognises in the conversation when an action fits, asks for what is missing, sums up, and sends only after the visitor says yes.
Templates
| Template | Asks for | Prefix |
|---|---|---|
| Create a support ticket | Type of request (bug, feature request, general), description, since when, e-mail; a photo if it helps | T |
| Arrange a call-back | Name, phone, preferred time, topic | R |
| Request a quote | Company, what is needed (product, quantity, date), e-mail, phone | A |
| Request an appointment | Name, preferred date, reason, e-mail | TE |
| Create a service order | Device and model, serial number, what is wrong, urgency (device is down, partly usable, routine maintenance), location, name, e-mail, phone; a photo of the type plate if it helps | S |
| Register a warranty | Device and model, serial number, date of purchase, bought from, name, e-mail; a photo if it helps | G |
Setting up an action, step by step
Every action has five stages. There is no flowchart: the bot runs the conversation itself.
- When: in your own words, when the action fits. “Someone reports a bug or has a request you cannot solve yourself.”
- Asks for: the fields the bot collects. For each field: name, type (text, choice, e-mail, phone), a hint for the bot and “Required”. For “Choice”, list the options separated by commas. + Add field for more. The tick Ask for a photo when it helps makes the bot ask for a picture (type plate, error message).
- Confirm: before sending, the bot sums up and asks whether it is correct. On by default; without that yes the server creates nothing.
- Then: where it goes. A route is “Always” or tied to a condition on a choice field (“If type of request = bug”). Routes are checked top to bottom; the last one without a condition acts as “otherwise”. Targets: E-mail, GitHub issue or a connected service (“ticket to Zendesk”, “message in Slack”). + Add route for more.
- Reply to the visitor: the sentence after sending, with placeholders such as
{ticket}and the fields ({email}). The bot translates it into the visitor's language.
Add a Name of the action and a Ticket number prefix: tickets are then numbered like T-1042. With active ticked, the bot can use the action.
Test run
The Test run checks every route without creating anything: is e-mail sending set up, is the GitHub repository reachable and private, does the service access work?
What happens with every ticket
- A ticket number, an entry under Contacts, a note in the conversation.
- A push notification to the team and, if set up, the webhook.
- If an e-mail address was asked for: a confirmation to the visitor.
- Photos from the chat are attached to the ticket e-mail (up to 5 files, 15 MB in total).
Built-in limits: at most 3 tickets per conversation per hour, at most 30 confirmation e-mails per hour. E-mail addresses and phone numbers never go into a GitHub issue, only the ticket number. If GitHub is down, the ticket goes by e-mail to the support address.
Try it: Try the bot
Ask the bot the way a customer would. The answer comes from the real bot with all documents and corrections. Each question is answered on its own, like a visitor's first question.
Settings
Eight groups in three sections: Account (My account, Team, Plan), Chatbot (Availability, Chat window, Chat tools) and System (Connections, Technical).
Searching the settings
Looking for “colour” or “password”? You do not need to know which group it is in: the search field at the top finds every card by heading, field names and hint text. Enter opens the first hit, Esc clears the field.
Saving: as soon as something is changed, the bar “Unsaved changes” appears at the bottom with Save and Discard. It saves everything that is open, including cards with their own button. If you try to leave with unsaved changes, you are asked first.
Online or Offline
At the very top of the settings you find Current status with a switch. Only you change it; nothing sets it automatically, not even signing in or out. Everybody starts as Online.
- Online: notifications make a sound, the Android app rings, reminders are repeated (as set under Notifications). Outside your opening hours, Talk to a human still reaches the team as long as at least one person is Online.
- Offline: everything arrives silently, without sound or vibration, and the Android app does not ring. If nobody is Online outside the opening hours, the visitor gets the e-mail form, and the chatbot keeps answering.
Set yourself to Offline at the end of your shift. Otherwise the team counts as reachable outside the opening hours, and visitors wait for a person who is not there.
Notifications
Which events make a sound while you are Online. Each person sets this for themselves; it applies to the dashboard, push notifications and the Android app.
| Switch | Meaning |
|---|---|
| New messages | A sound when a visitor writes to you or asks for a person. |
| Repeat new-message notification | The alert repeats until you open the conversation or close the notification (see Keep alerting). |
| Incoming visitors | A sound when a new visitor opens the chat on your site. |
My account
My profile
Your picture and name are shown to the team in the top bar, the member list and next to your replies. Visitors only ever see your display name. Choose photo… uploads a picture (cropped to a square and scaled down), Use initials removes it again.
Password
With a password you sign in directly, without waiting for a login link. At least 6 characters, enter it twice, Save.
Notifications on this device
Push has to be allowed once per device and browser: Turn on. The status above tells you whether it works (“Blocked” means: allow it in the browser or app settings, then reload).
Keep alerting until somebody answers
A notification rings once. To keep a phone that was put down ringing, the alert is repeated while a visitor is waiting. It stops as soon as someone takes over or the visitor leaves.
| Field | Meaning |
|---|---|
| Repeat every | Seconds between two alerts, at least 15 (default 60). |
| Keep going for | Minutes; 0 turns repeating off. |
Reliability check
Android puts apps to sleep to save battery, and a sleeping phone can swallow notifications completely. Test it the way it really happens: lock the phone, put it down, then press Send test notification. It should arrive within seconds. If it arrives late or not at all, the section Notifications arrive late or not at all explains the phone settings to change (battery optimisation, power saving, background use).
Team
Everyone gets their own user name. The Display name is what visitors see on your replies (“Eva”). Each person appears as a card with name, role, @user name · e-mail address and when they last signed in. An account without an address is marked in red: app.chatflamingo.com and the Android app find accounts by their address and cannot sign such an account in.
- Click + Add user. A window opens.
- Enter Display name, User name and E-mail, and choose the Role: Agent or Administrator (see Roles).
- Send invitation. The e-mail lets the person choose their own password, so nobody has to make one up for someone else.
Need an account without e-mail? Set a password directly shows a password field. Edit opens the same window for name, e-mail, role and active; the user name stays as it is. The ⋯ menu next to it sends a sign-in link, sets a password or deactivates the account. Open access links (for example from the welcome e-mail) are listed below and can be withdrawn.
Plan
Answer budget
How many bot answers this installation may spend per month. The bar shows usage, with a line such as “1,240 of 50,000 answers used this month (2%)” below it.
- At 80% the team gets one notification.
- At 100% the bot politely offers the e-mail form instead of answering. Conversations are still stored and you can reply by hand.
- Replies from people are always free.
- Stronger AI models count several times per answer; this is shown next to the usage.
Change plan opens the plan choice for Pro: the same as Free, same answer budget, only without the “ChatFlamingo free” note below the chat window (monthly, or yearly with two months free; prices plus VAT, the final price for your country is shown before you pay). Invoices & cancellation leads to the customer portal. Plans booked through Shopify are changed in the Shopify app. You can cancel any time, effective at the end of the paid period.
Delete account
Deletes the chat for good: all conversations, documents, settings and your team's logins. A running plan ends immediately, and the chat window disappears from your website. Type LÖSCHEN to confirm. This cannot be undone.
Booked a plan less than 14 days ago and want your money back? Please write to contact@chatflamingo.com first (right of withdrawal).
Availability
Support tickets
When a visitor cannot get help (outside office hours, or because nobody takes over in time), they can leave their e-mail address. The whole conversation is then e-mailed to your support address.
| Field | Meaning |
|---|---|
| Support email address | Tickets go here. |
| Offer email form after … minutes | How long a visitor waits for a person during opening hours before the form appears (1–120, default 5). |
| Email the team on new contact details | As soon as a visitor leaves an e-mail address or phone number in the chat, the team receives an e-mail. On by default. |
| Send contact alerts to | A different address for this, such as sales. Empty: the support address. |
Without e-mail sending set up, tickets are only stored in the dashboard. The yellow notice leads straight to Email / SMTP server.
Opening hours for human help
Inside these hours a help request rings in the dashboard, and the e-mail form only appears after the waiting time. Outside them, a person still takes over if someone is Online; if nobody is, the visitor is told right away and offered the form, with Continue with the chatbot to carry on with the bot instead.
- Tap the weekdays and choose the times from–to.
- + Add hours for more blocks, such as Saturday morning or a lunch break.
- Check the Timezone and save.
No hours set means: always available. If you prefer typing, open Edit as text: Mon-Fri 08:00-16:30, Sat 09:00-12:00 (days: Mon Tue Wed Thu Fri Sat Sun). The text visitors read about your hours is edited per language under Widget design & texts.
Special days
Public holidays, company holidays or one-off service days. On those dates they replace the weekly schedule.
- Choose From and, for several days, To.
- Enter Hours, e.g.
09:00-14:00. Empty means closed all day. - Optionally add a Note for visitors (“Company holiday”), then Add.
Chat window
Everything visitors see on your website. On large screens the Live preview runs alongside on the right: the real chat window with whatever is in the fields right now, even unsaved. Switch between Chat open and Before opening.
Put the chat on your website
- Copy the line.
- Paste it just before
</body>on your website, or into your shop's field for custom scripts (WordPress, Gambio, Shopware, JTL …). - Reload the page: the chat appears at the bottom right.
You never have to touch the line again, even if the chat moves to another machine. On Shopify this card instead says: Apps › ChatFlamingo › “Open theme editor”, then “Save”.
Chat link and QR code
A link of its own that opens the chat directly, even without a website: for a QR code at the counter or on flyers, your e-mail signature and social media. Copy link, Open, Download QR code (as a picture for printing). The link stays the same; what is printed stays valid. Add ?utm_source=flyer and Analytics shows where someone came from.
Widget design & texts
Changes apply on your website the next time a visitor loads the page.
| Field | Meaning |
|---|---|
| Brand color | Header, buttons, your own messages. |
| Circle colour | Inside of the round chat button and the disc behind the face; “same as brand colour” links the two. |
| Brand name | What the bot calls itself (“I am the assistant of …”). |
| Bubble position | Bottom right or bottom left. |
| Widget language | Automatic (browser language) or always one of 24 languages: German, English, French, Slovene, Dutch, Danish, Czech, Slovak, Polish, Spanish, Bosnian/Croatian/Serbian, Hungarian, Italian, Portuguese, Swedish, Finnish, Estonian, Latvian, Lithuanian, Romanian, Bulgarian, Greek, Maltese, Irish. |
| Ask the visitor's name | Before the chat starts. The name then appears in the list and in ticket e-mails; {name} in the welcome message greets the visitor personally. |
| …and their e-mail | Right after the name, skippable. A hard e-mail wall costs more conversations than it collects addresses. |
| Speech bubble by the button | For new visitors, a bubble next to the chat button. It disappears once the chat is opened. |
| Mascot | The face of the chat: Flamingo, Clavio, Maltese, Owl, Robot, Advisor, Luna, Clooney, Cindy, Fox, Penguin, Julia, Sarah, Maya, Thomas, David, Jonas, your own picture (PNG or WebP with a transparent background works best; scaled to 340 px) or no avatar. |
| Animate the face | It rocks and waves, the greeting card floats. Off: calmer, especially with a photo portrait. |
Texts per language
Choose the language at the top, then fill in the texts. Unsaved changes are kept while you switch languages; click Save once at the end.
| Text | Where it appears |
|---|---|
| Title, subtitle | Header of the chat window (“Summit Coffee”, “We reply instantly”). |
| Welcome message | The first message; {name} = the visitor's name. |
| Quick questions | The chips below the welcome message. Visitors tap one instead of typing. Empty fields are left out. |
| Office-hours text | What visitors read about your hours. Empty: the English text. |
| Proactive message bubble | See Proactive message. |
| Greeting while the chat is closed | The greeting card next to the button. |
| Greeting card button | e.g. “Get instant advice”. |
| Small bubble after closing | Appears after the card was closed. |
| Data-protection notice | Shown once in small grey type below the welcome message. Links as [text](https://…). Empty: no notice. |
Instant answers for the starter chips
When a visitor taps a quick question whose text is listed here, the answer comes straight from this text without asking the model. It costs nothing and arrives in two seconds. Upper and lower case and a trailing question mark do not matter. Choose the language, Add an answer, enter question and answer, Save. A language without entries goes to the bot as usual.
Proactive message
After a delay, a small bubble invites the visitor to chat, once per visit.
| Field | Meaning |
|---|---|
| Enabled | On or off. |
| Delay | Seconds until the bubble (3–600). |
| Only on pages containing… | Parts of the address, comma-separated, e.g. /coffee, /gear. Empty: all pages. |
| Exit intent | Desktop only: the bubble appears immediately when the mouse heads for the tab bar, even before the delay is over. Still once per visit. |
Rating follow-up: Google review & hotline
After a 👍 the visitor is invited to leave a Google review. After a 👎 the chat first asks what went wrong and what could be improved, then offers the team and the hotline; the review invitation comes last and in softer wording.
- Google review link (e.g.
https://g.page/r/…/review). Empty: no invitation. - 24 h hotline number. Empty: no hotline button.
WhatsApp button
A WhatsApp button in the chat window's header. A tap opens WhatsApp on the visitor's phone or computer with a chat to your number. Number with country code, optionally a pre-filled message. Try the button → tests it.
Conversations on WhatsApp through this button do not run through the chat: no bot answer, no entry in the dashboard. If you want the bot to answer on WhatsApp itself, connect WhatsApp Business as a channel.
Chat tools
Canned responses
Ready-made replies for your team, available with / in the reply field. Enter a Shortcut (e.g. shipping) and the Text, then Add. Also here: the Remote support download link. With the canned response /fernwartung your team sends it into the chat; when empty, that shortcut is hidden.
Agent Copilot
AI reply suggestions for your team (the ✨ Suggest button in a conversation). They are based on the conversation and your knowledge base; your team always reviews and edits them before sending. Switch them on or off here.
Connections
Everything that links the bot to other systems: shops, ready-made services, your own systems, GitHub, webhook and recognising signed-in customers. The row in the settings list shows how much is connected.
Access credentials stay on the server and are never shown in the dashboard again. Only administrators see this group.
Shops
| Shop | What the bot can do | What you need |
|---|---|---|
| Shopify | Find products with price and availability, show them in the chat with a picture, add them to the cart; answer questions about shipping and returns from the shop's own information. | Just the shop address. No key, no app. |
| WooCommerce | Order status (with order number and e-mail), products with price and stock, cart. | The “ChatFlamingo” plugin, version 1.2 or later. Easiest: in WordPress under Settings › ChatFlamingo click “Connect with ChatFlamingo”, then confirm here. Otherwise enter the address and the key from the plugin. |
| Shopware 6 | Products with price, variants and availability, cards with pictures, cart; with an integration also order status. | Address and the sales channel access key (Sales Channels › Storefront › API access; not secret). For order status, an integration without “Administrator”, with a role that may only read orders. |
| Magento 2 | Like Shopware; also Adobe Commerce and Mage-OS. | The address is enough for products and cart. For order status, an integration that may only read “Orders” and “Shipments”, and its access token. |
| Gambio (order status) | Order status. | API base URL (https://…/api.php/v2) and API token, tick “Enable order-status lookups”. |
Order status only with proof: before the bot reveals anything, it checks the order number against the e-mail address or the last name on the order. A guessed number alone gets nobody any data. It only ever tells the status, the order date and the tracking number, never addresses, prices or line items. After eight failed attempts per conversation per hour it stops.
Services: more than 90 ready-made connections
Ready-made connections to your team's tools. Connected services are then available as targets under Bot › Actions (“Then: ticket to Zendesk”), or they give the bot new abilities in the conversation (tracking parcels, booking appointments, quoting reviews).
- Search for the service in the search field, e.g. “slack”.
- Click Connect. A short guide tells you where to find the access details in that service.
- Enter the access details and click Connect. The access is checked immediately; if it does not work, you are told what is missing.
- Where offered: only switch on Include contact details (e-mail, phone) if nobody outside your team can read the target.
| Group | Services |
|---|---|
| Notify your team | Slack, Microsoft Teams, Discord, Telegram, Google Chat, Mattermost, Rocket.Chat |
| Helpdesk and tickets | Zendesk, Freshdesk, Zammad, Help Scout, Intercom, Gorgias, Znuny / OTRS, Front |
| CRM and sales | HubSpot, Pipedrive, Salesforce, Zoho CRM, Microsoft Dynamics 365, Odoo, weclapp, CentralStationCRM, Freshsales, Bitrix24, EspoCRM, Close |
| Tasks and spreadsheets | Jira, GitLab, Trello, Asana, ClickUp, monday.com, Notion, Airtable, Google Sheets, Linear, Todoist |
| Newsletter | Mailchimp, Brevo, CleverReach, KlickTipp, rapidmail, Klaviyo, ActiveCampaign (double opt-in only) |
| Appointments | Cal.com, Calendly, Google Calendar, Microsoft Outlook, Microsoft Bookings, SimplyBook.me |
| SMS | Twilio, sipgate |
| Accounting | Lexware Office, sevdesk, Billomat, FastBill, easybill |
| Shops and marketplaces | JTL-Shop / JTL-Wawi, plentymarkets, OXID eShop, PrestaShop, BigCommerce, Wix, Ecwid, Squarespace, Amazon (Seller Central), eBay |
| Shipping and tracking | DHL, DPD, GLS, Hermes, Sendcloud |
| Payments | Stripe, PayPal, Mollie |
| Inventory and ERP | Xentral, Billbee, Microsoft Dynamics 365 Business Central, SAP Business One |
| Reviews | Google reviews, Trustpilot, ProvenExpert |
| Channels | WhatsApp Business, Facebook Messenger, Instagram |
| Knowledge sources | Google Drive, SharePoint, Confluence, Dropbox |
What is special about the groups:
- Newsletter services only subscribe with the provider's double opt-in; an address from the chat may belong to someone else.
- Appointments: the bot names free slots and books only after a summary and the visitor's yes.
- Payments: payment links only after a yes, with a maximum amount, at most three per conversation.
- Shipping: parcel tracking without recipient details.
- Channels: the bot answers there itself; your team takes over in the dashboard like any other chat. After connecting, the card shows the webhook address and the verify token for Meta.
- Knowledge sources: files come into the knowledge base with the Import now button and then daily.
- Reviews: the bot quotes real reviews with their source and gives the link for leaving a review.
Services marked Preview are built from the provider's documentation but have not yet been checked with every real account. The check when connecting shows immediately whether your access works. Please report any problems to us.
Connected systems and Connect a system (MCP and OpenAPI)
Under Connect a system you link your own systems, such as inventory management, stock levels or your own portal. The bot uses their released tools in the conversation. The card Connected systems above lists them with their tools.
- Type: MCP server or OpenAPI interface. Name, e.g. “Inventory”.
- The address of the MCP server or of the OpenAPI description; for OpenAPI, optionally a different base address.
- Authentication: none, bearer token, API key (name, sent as header or URL parameter, value) or user and password.
- Connect. The tools appear in the list above.
- Reading tools are on straight away. Tools that change something stay off until you release them one by one.
Up to 10 systems. Names and descriptions from outside systems are only shown as text, never run as code.
GitHub access
For actions that create a GitHub issue. Best is a “fine-grained token” that may only write issues in that one repository (permission “Issues: Read and write”). Save or Remove. E-mail addresses and phone numbers never go into an issue, only the ticket number.
Webhook (Zapier, Make, CRM)
Sends new contacts and requests straight to an address of your choice, for example a “Catch Hook” in Zapier or Make, or directly to your CRM.
- Enter the Webhook address (
https://…). - Choose the events: New contact (e-mail or phone left in the chat), New request or ticket (e-mail form and actions), Every new chat (a visitor's first message).
- Save. The Key for checking the signature appears.
- Send a test and check in the target that it arrived.
Every call is signed: header X-ChatFlamingo-Signature, HMAC-SHA256 over the body. Every action sends the ticket number (ticket), the action (action) and all fields (fields). Example in Zapier: “Catch Hook” › “Filter” on action = ticket › “Slack: Send Channel Message”.
Recognise signed-in shop customers
When a customer is signed in to your shop, the shop can pass their name and e-mail to the chat. The bot then no longer asks for them, and the order number alone is enough for the order status.
- Create key.
- Put the key only into your shop's server code, never into the page.
- Insert the code shown before the embed line. It passes name, e-mail, customer number and a signature (HMAC-SHA256 over the lower-case e-mail).
The signature is created on the shop's server. If the key were in the browser, anyone could pose as any customer.
Technical
Email / SMTP server
Used for ticket e-mails, contact alerts and confirmations. If the card says “Nothing to set up”, the platform already sends e-mail itself; your own server is then optional and takes over once it is filled in.
| Field | Example |
|---|---|
| SMTP host | smtp.office365.com, smtp.gmail.com (with an app password), Brevo … |
| Port | 587 |
| Username | tickets@your-company.com |
| Password | Leave empty to keep the stored one. |
| Sender address | Optional; defaults to the user name. |
Send test email checks sending to your support address.
AI model
Which model answers visitors (also used for Copilot drafts and “Test the bot”). Stronger models answer better but count several times per answer. The number after each model says how often an answer counts: 1, 4, 20, 50 or 100. The default, Standard, counts 4.
Thinking effort (models with thinking only): automatic, minimal (fastest), low (a good balance for chat), medium (thorough), high (slow, maximum care). More thinking helps with tricky questions but delays the first words. Changes apply from the next answer. If unsure, leave it on Standard.
Website access
Which websites may embed the chat. Empty: every site (fine for testing). Once your domains are entered, the chat only works there; someone who copies the line into a foreign site does not spend your budget. Subdomains count automatically: example.com covers www and shop.example.com.
Storage
Photos, files and transcripts live in the database. The bar shows usage, broken down by type, followed by the largest files.
| Automatic clean-up | Meaning |
|---|---|
| Delete automatically | Turns clean-up on; it runs daily. |
| Delete files after … days | Photos and files. 0 = keep forever. The transcript text stays. |
| Delete whole conversations after … days | 0 = keep forever, otherwise at least 30 days. |
Roles and permissions
| What | Agent | Admin |
|---|---|---|
| Read, take over, reply to and assign chats | ✓ | ✓ |
| Notes, tags, handover, contacts | ✓ | ✓ |
| Analytics | ✓ | ✓ |
| Corrections, missed questions, sources, answer style | ✓ | ✓ |
| Own profile, password, notifications | ✓ | ✓ |
| Actions | – | ✓ |
| Setup assistant | – | ✓ |
| Manage team and accounts | – | ✓ |
| Connections (shops, services, systems, GitHub) | – | ✓ |
| Change plan, delete account, automatic clean-up | – | ✓ |
Privacy and security
- Credentials for shops, services and systems stay on the server and are never shown again, not even to administrators.
- Order status only with proof (e-mail or last name), never addresses or prices, and a brake after eight failed attempts.
- Contact details only go where you allow it: never into GitHub issues, into team channels only with the “Include contact details” switch.
- Actions create nothing without the visitor's yes; limits per conversation and hour prevent abuse.
- Webhooks are signed, and signed-in customers are only recognised with your shop's signature.
- Website access limits the chat to your domains.
- Clean-up deletes files and conversations after your deadlines; you can delete single conversations by hand at any time.
- The data-protection notice in the chat is edited per language under Widget design & texts.
Frequently asked questions
Is there a quicker way to set everything up?
Yes: the setup assistant (✨ Assistant in the top bar). Describe what you need, and it prepares actions, settings and knowledge for you to confirm.
How do I put the chat on my website?
Under Settings › Chat window › Put the chat on your website, copy the line and paste it before </body>. On Shopify, switch it on in the theme editor.
The bot said something wrong. What do I do?
Click Fix this answer below the answer in the chat, or write a correction under Bot › Fix answers. It applies from the next answer.
The bot does not know something. How do I teach it?
The question is listed under Missed questions: click Answer. For whole topics, upload a document.
What happens when nobody is available?
Outside your opening hours the visitor is told right away and offered the e-mail form. The request arrives at the support address with the whole conversation.
I do not get notifications on my phone.
Install the dashboard as an app, turn notifications on under My account and send the test with the phone locked. On Android, switch off battery optimisation for the app.
Does it cost anything when my team replies?
No. Only bot answers count towards the answer budget.
What happens when the answer budget is used up?
The bot offers the e-mail form. Conversations are still stored and your team can reply. The budget starts again on the first of next month. Need more than 50,000 answers a month? Write to contact@chatflamingo.com (Wild, on request).
Can the bot create tickets or arrange call-backs?
Yes, with actions: by e-mail, as a GitHub issue or in a service such as Zendesk, HubSpot or Slack.
Which languages does the bot answer in?
In the visitor's language. The chat window is available in 24 languages; in the dashboard, “Translation: auto” translates a conversation both ways.
Can I use the chat without a website?
Yes, with the chat link and QR code.
How do I connect my shop?
Under Connections › Shops: Shopify and Magento with the address, WooCommerce through the plugin, Shopware with the access key, Gambio with the API token. Many more shops are under Services.
Can an agent change the settings?
Agents do not see actions, connections, team or plan. See Roles.
Glossary
| Term | Meaning |
|---|---|
| Action | Something the bot does for visitors (ticket, call-back, quote), with questions and a confirmation. |
| Answer budget | Number of bot answers per month: up to 50,000 under fair use, the same in Free and Pro. |
| Copilot | AI drafts for your team's replies. |
| Correction | A sentence that overrides older documents. |
| House style | Your rules for how the bot sounds. |
| MCP | Model Context Protocol: a standard through which your own systems offer tools to the bot. |
| Missed question | A question the bot could not answer from its knowledge. |
| OpenAPI | A description of an interface from which the bot builds tools. |
| Quick questions | Chips below the welcome message. |
| Service | A ready-made connection to a tool such as Slack or HubSpot. |
| Setup assistant | The chat in the dashboard that suggests settings, actions and knowledge for you to confirm. |
| Sitemap | The list of all pages of a website, usually at /sitemap.xml. |
| Take over | A person replies instead of the bot. |
| Webhook | An automatic call to an address when something happens, for example for Zapier. |
| Widget | The chat window on your website. |
Versions
| Version | Date | Contents |
|---|---|---|
| 2.3.0 | 27 Sep 2026 | New: Online/Offline status for each person, the Notifications menu, and the redesigned Team list with its own window for adding and editing. |
| 2.2.0 | 27 Sep 2026 | New: voice messages to the setup assistant (microphone or uploaded voice memo). |
| 2.1.0 | 27 Sep 2026 | New: the setup assistant in the dashboard. |
| 2.0.0 | 27 Sep 2026 | Every area of the dashboard (build c9c342a), with pictures, search, FAQ and glossary. |
How the version number grows: the last digit for corrections to the text, the middle one for new dashboard features, the first for a new structure.