Alberto

Troubleshooting & FAQ

This page is grouped by what you are seeing. Use your browser's find-in-page (Ctrl/Cmd+F) to jump straight to it. If a word is unclear, see the Glossary. If nothing here helps, contact support and say what you tried.

Channels and connections

Meta says webhook verification failed

  • Copy the Callback URL and Verify token again from the channel's page in Alberto, and paste them into Meta. Do not retype them: one extra space is enough to fail.
  • Check that you pasted them into the right product in Meta (WhatsApp, Messenger or Instagram) and pressed Verify and save.
  • If it still fails, contact support.

Messages arrive in the Inbox, but the AI never replies

Check, in order:

  1. Does the channel have an assistant, and does that assistant have a knowledge base, and is it switched on? Without one, Alberto records the message but has nothing to answer from. See Assistants.
  2. Has someone taken over the conversation? The AI stays quiet in a conversation a person has taken over.
  3. Open the conversation in the Inbox. A failed AI attempt shows as a message marked Failed, with the reason. The sections under AI answers below explain each reason.
  4. If there is no failed message and still no reply after a few minutes, contact support.

My own system gets "429 Too Many Requests" from a webhook address

Each channel's webhook address accepts up to 120 requests a minute from one address. Real customer messages never come close. If you see this, something is calling the address in a loop, such as a monitoring tool or a misconfigured retry. Stop it, and the address works again within a minute.

Instagram, Messenger and the website widget

The AI never sends a picture on Instagram

Instagram does not let Alberto send pictures, so the AI replies with text only on Instagram. Pictures customers send you still arrive. Messenger and WhatsApp can send pictures. See Connecting Instagram.

The website widget does not appear on my site

The most common cause is a strict Content-Security-Policy on your own website, which blocks the widget without any visible message. Open your browser's developer console and look for a CSP error. Then ask whoever manages your website to allow the Alberto address in script-src and connect-src. See Connecting the Website Widget.

Webhooks and lead forms

A webhook endpoint never receives anything

Open the endpoint's delivery log under Webhooks. If every attempt shows a connection error, your own server or firewall is blocking the requests. Make sure the address is public and does not only accept requests from a browser or from certain IP addresses. See Webhooks.

A lead form is never offered to customers

Open the form under Lead Forms and check that it is Active and attached to a knowledge base or a channel. A form with neither is saved but never used. See Lead Forms.

A returning customer is not asked the lead form again

That is on purpose: each customer is asked a form only once, even in a new conversation. Attach a different form if you want to ask them new questions. See Lead Forms.

AI answers

The AI always says it does not have enough information

This is the answer the AI gives when nothing in your knowledge base fits the question. It is there so the AI never makes things up. If your content should cover the question, ask it in the Playground to see what was found, and improve your documents. See Knowledge Base.

A conversation shows "Failed" and mentions the AI service

The AI service was briefly unavailable. Alberto tries again three times, after about 30 seconds, 2 minutes and 5 minutes, so the customer usually gets the reply a little late with nothing for you to do. If every attempt fails, your team is notified and the conversation shows Failed in the Inbox, so a person can answer instead.

The AI stopped answering and we got an email about it

The AI service is not available on the platform at the moment. Answer customers yourself in the Inbox meanwhile, and contact support if it lasts.

Knowledge base and documents

A document is stuck on "Processing"

Most documents finish within a few minutes. If one is still processing an hour later, contact support. There is nothing to fix inside your workspace.

A document failed with "no extractable text found"

The file has no real text in it. This is usually a scanned PDF (a picture of a page), a password-protected PDF or an empty file. Run it through OCR first, or export it again as a text PDF or DOCX.

A web page document failed for being too large

A web page can bring in at most 20 MB, the same as a file upload. Link a smaller page, or copy the text you need and use Paste text instead.

An upload was rejected although it is the right file type

Alberto checks what is really inside a file, not only its name. A damaged file, or a file renamed to end in .pdf, is refused. Save or export the file again and upload the new copy.

A knowledge base is marked "Frozen"

It cannot take new content at the moment, but it still answers questions. Contact support, or put new content in a new knowledge base. See Knowledge Base.

Conversations and escalation

A customer asked for a person, but the AI kept replying

Alberto spots common phrases such as "talk to a human" and flags the conversation for your team. Whether the AI then stops depends on Automatically switch to human under Settings → Escalation. When it is off, the AI keeps answering so the customer is not left waiting, and the conversation stays flagged for a person. See Escalation.

How do I take a conversation over from the AI?

Open it in the Inbox and take it over. The AI stops replying in that conversation at once, and what you send goes out from you. See Inbox.

I do not get escalation emails

Check Email active users under Settings → Escalation, and look in your spam folder. If it is on and nothing arrives, the platform's email may not be working. Contact support.

Inbox and team

A conversation was handed over but nobody was assigned

With Automatically assign agents on and two or more agents, the AI assigns only when it finds a clear match between the question and an agent's designation. Otherwise the conversation waits under Waiting. Give your agents clearer designations on the Team members page. See Your Team.

A saved reply still shows {{contact.name}}

That customer has no value saved for that detail. The code is left as written on purpose, so you notice before sending. Add the detail in the contact panel, or type it yourself. See Inbox.

I mentioned a teammate in a note but they got no email

Check that you picked their name from the list that appears after typing @. If you did, the platform's email may not be working. Contact support.

The "waiting" badge does not go away

Only a reply to the customer clears it. A note for your team does not.

Contacts & Broadcast

An import left some rows out

The message after the import says why. The usual reasons are a missing phone number, the same number twice in the file, a value that does not fit its field type, or your plan's contacts limit. See Contacts.

People lost their opt-in after I imported a list again

Importing people who are already in the channel with the opt-in box unticked clears their opt-in. Import the list again with the box ticked, if those people did agree.

A campaign cannot be sent

A person you ticked by hand has not opted in. Untick them, or mark them opted in on the Contacts page if they agreed. On WhatsApp you also need an approved template.

A campaign is still sending the next day

The number reached Meta's limit for 24 hours, or its warm-up budget for the day. The rest goes out when there is room. See Broadcast.

A campaign was paused by itself

WhatsApp lowered the number's quality rating to yellow or red. Review your audience and message, then open the campaign and click Resume.

A template was rejected

Use Check template before submitting. It finds the common causes, such as variables out of order or text that starts or ends with a variable. Meta's own reason is shown in Meta's dashboard.

Automations

An automation did not run

Check that it is Active, that the contact matches its filters, and that it has not already run 5 times for that contact in the last hour. Then open Run history. See Automations.

A "Send a message" step failed

On WhatsApp, Instagram and Messenger, a free-form message can only be sent within 24 hours of the customer's last message. Use Send a WhatsApp template for anything sent later.

The customer got an automation message and an AI answer

The AI stays quiet only when the automation starts with a send step. Move the send step to the top, or add Pause the AI.

I cannot switch from Canvas back to List

An automation with branches can only be shown on the canvas. The list can show a single straight line of steps.

Deals

Deals, Automations or API access is missing from the menu

Your plan does not include that feature. See Plans & Billing.

I cannot delete a stage or a pipeline

A stage must be empty before it can be deleted, so move its deals first. The default pipeline, and a pipeline that still has deals, cannot be deleted.

WhatsApp links & lead ads

A WhatsApp link gets clicks but no conversations

People open the link but do not press send, or they delete the reference code from the message. Also check that the number saved on the link is the number of the channel you chose. See WhatsApp Links.

No lead ad leads are arriving

The connection must be switched on, Meta must have approved the leads_retrieval permission, and the Page must be subscribed to leadgen. See Meta Lead Ads.

API

The API answers 401, 403, 429 or 422

401 means the token is wrong or revoked. 403 means the token is not allowed to do that. 429 means more than 60 requests in a minute. 422 on a text message means the 24-hour window has closed, so send a template. See Integrations & API.

Inbox, templates and statuses

A conversation vanished from my list

It may be Snoozed (open the Snoozed tab), Resolved, or filtered out by a label or channel. A snoozed conversation returns by itself at the time you chose, or when the customer writes. See Inbox.

I can only choose a template, not type a reply

The 24-hour reply window is closed (48 hours on WeChat). Pick an approved template, or wait for the customer to write. See WhatsApp Templates.

My template is stuck on Pending or Rejected

Pending usually clears within a day; click Sync from Meta to refresh. For Rejected, the reason is shown on the card: click Fix, change the text (often a missing example or a variable at the very start or end) and Resubmit.

An auto reply did not fire

Check it is Enabled, its channel matches, the keyword really appears in the message, and a rule with a lower priority number is not answering first. See Auto Replies.

SMS and email

SMS shows Sent but never Delivered, or customers cannot reply

Your SMS provider may not send delivery reports or replies (the table on the SMS page shows which). For providers that do, the inbound address must be pasted into the provider's dashboard.

An email campaign cannot be launched

Add your business address under Settings, Workspace, and make sure the subject and the email are filled in. See Email.

Emails land in spam or bounce

Send through a proper service with your domain set up (SPF and DKIM), keep your list clean, and check the campaign report for Bounced recipients. See Email.

Texts or emails say my plan's monthly limit has been used up

Your plan caps SMS or emails per month. It starts again next month; upgrade for more. See Plans & Billing.

Stores, leads and social

My store shows an error or orders are missing

Open Stores: the card shows the store's last message. Press Edit, enter fresh keys, then Test and Sync now. See Online Stores.

An order or cart does not show beside the conversation

Orders are matched by the customer's phone number or email. If they used a different one in the shop, there is no match.

A Lead finder search failed

The message says why: quota used up, key refused, place not found, or your lead credits ran out. See Lead Finder.

I cannot add a lead to a campaign

Leads from the Lead finder or a store have consent off on purpose. Record that they agreed first. See Contacts.

A social post failed or an account says Token expired

Open the post: each account shows the network's reason. For an expired token press Reconnect. See Social Media.

Account, data and billing

I did not get my data export

Check spam and the bell. The page shows "Building your export…" until ready. The link works for 72 hours; request a new one if it expired. See Data and Security.

My promo code was refused

The message under the box says why: not found, switched off, expired, used up, not valid for this plan, or already used by your workspace. See Plans & Billing.

I do not see Reports, Assistants or Media library

They are Admin areas. Agents do not see them. See Your Team.

Plans and access

I am sent to the plans page, or my agents see "Your account is inactive"

Your workspace has no active plan: it was never started, it ended after being cancelled, or the payment did not go through. As the Admin, choose a plan under Settings → Plans. See Plans & Billing. If that does not look right, contact support.

A menu item such as Broadcast is missing or locked

Your plan does not include that feature. See what your plan includes, or upgrade, under Settings → Plans. See Plans & Billing.