Skip to content

AI assistant and your key

The assistant adds a question box to your button. It answers visitors’ questions from your own website, PDFs and Q&A entries, shows where each answer came from, and offers your channels or the contact form when it isn’t sure.

It runs on your own AI key, so your AI provider bills you directly at their prices. Talkixa never charges for AI and never uses a key of its own. The assistant is optional: the button, channels and contact form work without it.

1. Get a key

Create an API key with the provider you prefer. You pay that provider for what visitors ask.

ProviderWhere to create a key
Anthropic (Claude)console.anthropic.com/settings/keys
OpenAIplatform.openai.com/api-keys
Google Geminiaistudio.google.com/apikey
OpenRouteropenrouter.ai/keys
Other (OpenAI-compatible)Any service with an OpenAI-compatible API: paste its address and key.

2. Connect it

  1. In the dashboard, open your site and go to AI assistant.
  2. Choose the provider, paste the key and pick a model, then turn the assistant on and save.
  3. Use Try it to ask a question the way a visitor would.

Before it answers your Inbox by itself, use Try a conversation: write as a customer would, on WhatsApp or in website chat, or tap one of the ready questions made from your products, such as a price, an order to one of your delivery areas, or something it can’t answer. You see its reply, each thing it would do (search your products, take an order, pass it to your team), and why. Nothing is sent, and no order, booking or lead is made. It costs what a real message costs.

For Claude, these models are offered. The first is the default, and enough for most sites:

ModelPrice per million tokens (in / out)
Claude Haiku 5.5 (default)$0.10 / $0.50Fast, lowest cost. Good for most sites.
Claude Sonnet 5.5$2 / $10More capable, 20× the cost of Haiku.
Claude Opus 5.5$4 / $20Most capable Claude model here, 40× the cost of Haiku.

For other providers, type the model name exactly as your provider shows it.

3. Teach it about your business

Under What it knows:

  • Read my website reads your pages, starting from your sitemap. Add your website address on the Install page first.
  • Add a PDF adds a menu, price list or brochure. The text is taken out in your browser; the file itself is never uploaded. Scanned PDFs without text can’t be used.
  • Q&A entries are short questions and answers you write yourself, for things your site doesn’t say.

Each site can hold up to 30 or 150 pages, PDFs and entries, depending on your plan.

Once it has read your site, Set it up from your site suggests, from your pages and products: a few lines on what your business is, how it should talk to customers (friendly Egyptian Arabic, formal, or warm and brief), common questions answered from your delivery, returns and payment pages, your delivery fees when your pages give them, and WhatsApp messages to create as templates. Nothing is saved until you tick what you want and press Save what I picked.

It learns what it couldn’t answer

Questions it couldn’t answer are listed under Questions it couldn’t answer. When it handed a conversation in your Inbox to your team and they replied, their reply is there too, as the answer: press Add this answer and it knows it next time, orEdit first to change the words. Dismiss takes a question off the list, with the same words asked again.

Every Monday, your phone gets a summary: how many questions went unanswered that week, and which came up most.

Answers in your Inbox

The assistant can also answer customers in your Inbox: website chat, Telegram and WhatsApp, and Messenger and Instagram once they’re available. On the AI assistant page, choose when under Answer messages in the inbox:

  • Off: your team answers every message.
  • Outside business hours: it answers while you’re closed, by your widget’s business hours. Set those under Widget → Behavior first.
  • Always: it answers every message first, day and night.
  • Drafts for my approval: it writes a reply to every message and sends nothing itself. The draft waits above the reply box in the Inbox: Send it, Edit first, or dismiss it. A new message from the customer gets a new draft, and any reply takes it away. Drafts don't place orders, book times or save leads, since nobody has approved them yet, and each counts toward your daily limit.

It waits a few seconds so that several short messages get one answer, answers in the customer’s language from what it knows, and stays quiet for things like “ok” or a thumbs up. When it isn’t sure, or the customer asks for a person, it tells them the team will reply, leaves your team a note with the reason, and stays out of that conversation until someone from your team replies. It also stays out for ten minutes after a team member writes, so it never talks over you. Your daily limit and your saved answers apply, as they do for the button.

Orders and bookings

When your site takes orders or bookings here, the assistant does too, on your button and in your Inbox:

  • Orders: it takes an order from your list with the customer’s name and phone, asks which size or color of an item that comes in options, tells them your delivery fee and asks for their area and how they’ll pay when you’ve set those up, takes a discount code they write, and gives them the order number. It answers “where’s my order?” once they give the number and the phone or email they ordered with.
  • Bookings: on your button and in website chat, it shows a Book a time button that opens your booking view. On WhatsApp and your other channels, it finds the free times for a service, says who of your team is free at each, and books the time they choose once they give their name and phone.

It uses only a phone number or email the customer wrote, or that the channel knows, and never says an order or a booking went through when it didn’t.

Selling, not only answering

Under How it talks to customers, choose Answer questions or Sell too. To sell, it needs your products, in Products and services or a connected store:

  • When it isn’t clear what fits, it asks what they need, one short question at a time, at most two.
  • It suggests up to three products, each with a reason it fits, and may suggest one item that goes well with their choice, once.
  • Then it helps them order: it takes the order when your site takes orders here, or points them to the product’s button or page.
  • Prices and stock always come from your list or your store. It doesn’t push: when they say no, it stops.

You can also let it give one discount code of yours, under Discount it can offer. It offers the code only when someone hesitates over the price or asks for a discount, once, with its terms, and it can add it to the order it takes. Set the code’s minimum order, and Once per customer, on the code itself.

Pictures customers send

In your Inbox, the assistant looks at pictures with Claude, OpenAI, OpenRouter and Gemini. With Gemini, the picture is described first, and your team sees that description under it, marked What the assistant saw. With a custom provider, it passes pictures to you.

  • A product: it looks for the closest products in your list and shows them.
  • A transfer receipt, such as an InstaPay or Vodafone Cash screenshot: it reads the amount and the reference, and notes on the order that the customer says they paid, with your team alerted. It never marks an order paid: a screenshot is easy to fake, so you check that the money arrived and turn on Paid yourself.

Popular questions

Under Popular questions, add up to 4 questions visitors often ask, such as “Do you take insurance?”. They appear on the button’s start screen, and a visitor gets the answer with one tap. Each answer is saved after the first time, so later taps usually cost nothing.

Visitors rate the answers

After each answer, visitors can say whether it helped. When it didn’t, the assistant offers the contact form and your channels. Answers marked unhelpful are listed under Answers visitors found unhelpful, so you can write a better one and the assistant uses it next time.

How it answers

  • It answers only from what it has read, and links to the page each answer came from.
  • When nothing it has read fits, it says so and offers your channels or the contact form, without calling your AI provider.
  • When your customer’s words match nothing it has read, it can search once more in other words: in English and Arabic, in Franco-Arabic, and with words that mean the same, all in the same answer.
  • It answers in the visitor’s language, and understands everyday Arabic dialect as well as English.
  • You can give it short instructions, such as the tone to use or what to suggest.
  • It knows the page the visitor is on, on your button and in website chat: on a product’s page, “is this in stock in L?” means that product. Those answers aren’t saved for the next visitor, since the same words on another page are another question.
  • With the WordPress plugin on a WooCommerce shop, it also knows what’s in the visitor’s cart, and who they are when they’re signed in to your shop, as your shop says it. A signed-in customer can ask where their order is with only its number.

Keeping costs predictable

  • Set a daily limit (200 questions by default). A voice note heard and a new lead’s summary each count as one. Once it’s reached, the Ask tab says the assistant isn’t available and offers your channels and the contact form until the next day (days are counted in UTC). Leads still come in, without the summary.
  • Each visitor can ask up to 20 questions in 10 minutes.
  • Questions that match nothing on your site don’t reach your provider at all.
  • The Usage card shows the tokens used per day, with estimated costs for Claude models.

When your provider refuses

If your provider refuses calls, the assistant hands those conversations to your team, and a note on the AI assistant page says why. It goes away when a call works, or when you change the key, provider or model.

  • The quota ran out: your provider’s daily quota or your prepaid credit is used up. Wait for it to reset, or add credit. Gemini’s daily quotas reset at midnight Pacific time.
  • Requests are being limited: too many questions came at once. This usually clears within a minute.
  • The key was refused: check the key with your provider and save it again.

Your key’s safety

Your key is encrypted before it’s stored (AES-256-GCM), is never sent to visitors’ browsers, and is used only to answer questions on your site and to summarize contact-form messages for you. The dashboard shows only its last four characters. You can remove it at any time.