Troubleshooting
Fixes for the most common problems, from disconnected accounts and failed posts to missing messages, emails and features.
On this page
Something not working as expected? Find the problem below. Most issues come down to one of four things: an account that needs reconnecting, a platform rule, your role or your plan.
An account says "Disconnected", "Error" or "Reconnect needed"
Social networks ask you to sign in again from time to time, for example when a password changes, access expires or a permission is removed. Until you do, Luminobot can't publish to that account or fetch its messages.
- In the sidebar, the account appears faded with a reconnect button. Accounts that need attention show Reconnect needed on the connect page, and Disconnected, Error or Token Expiring under Workspace settings → Social Accounts.
- Open the account and click Reconnect, then sign in to the network again with the same account. Grant every permission it asks for.
- If you see Reconnect before scheduled posts fail, access is about to expire or a publishing permission is missing. Reconnect now so scheduled posts go out.
Only people who can manage connected accounts (workspace owners and managers by default) can reconnect. Others see Disconnected and should ask a workspace owner or manager. See Connect your channels.
A post failed
- Click Publishing in the sidebar and open the Sent tab. A failed post shows the network's reason under it.
- Open the post: a red box says Publishing failed for the accounts that failed, with the reason for each.
- Before giving up, Luminobot retries a few times on its own. While it does, the Queue tab shows Retrying with the attempt number.
Fix the cause (often reconnecting the account, or changing media that breaks a network's rules), then schedule or publish the post again. You also get a Post failed notification.
Common causes:
- The account needs reconnecting (see above).
- Instagram allows 50 posts per account in 24 hours.
- X charges for every post, so your plan may cap X posts per month. Over the cap, X posts fail with a clear message.
- TikTok posts made through the API may be limited to private until the app's TikTok review is complete.
Messages aren't arriving in the inbox
- Check that the account is connected (see the first section). For WhatsApp, Telegram and SMS, open Chat channels and check the channel's status.
- Check your view. Open Social Inbox, choose the All tab and All statuses. A conversation may be resolved, archived or snoozed.
- Check your access. Your role may limit you to some accounts, or to conversations assigned to you. Ask an admin to check your Access on Team Members.
- On a WhatsApp Business (Cloud API) channel, a warning that no app secret is saved means incoming messages are being rejected. Reconnect the channel and enter the app secret.
Older messages from before you connected may not be imported on every network.
"Outside the 24-hour reply window"
Messenger, Instagram and WhatsApp Business only let businesses reply freely within 24 hours of the customer's last message.
- Messenger and Instagram: a person can still reply for up to 7 days using Meta's Human Agent feature. Automated replies (workflows, AI Employees) can't. After that, the customer has to message you first.
- WhatsApp Business: after 24 hours you can only send an approved template. Create one under WhatsApp Templates and send it; free-form replies work again once the customer answers.
A reply that couldn't be delivered shows Not delivered. Hover over it to see why.
WhatsApp (QR) disconnected
WhatsApp connected by QR code works through a linked device on your phone. If the phone unlinks it, the channel shows Logged out.
- Go to Chat channels.
- Click Rescan QR next to the channel.
- On your phone open WhatsApp → Settings → Linked devices → Link a device and scan the new code.
Keep the phone online. If the channel shows Blocked by WhatsApp, WhatsApp has refused the number. Check WhatsApp on the phone first.
Remember that the QR connection is not an official WhatsApp API. WhatsApp can ban numbers that look automated, so never use it for bulk messages. For volume, use WhatsApp Business (Cloud API). See Connect WhatsApp with a QR code.
"AI credits used up" or "AI budget reached"
- AI credits used up: the workspace has used this month's AI credits included in its plan.
- AI budget reached: your organization's own monthly AI limit has been reached.
An organization owner or admin can fix either in Settings → AI: add your own provider key, raise the budget, or upgrade the plan or buy more credits. Otherwise AI starts again next month. Meanwhile, AI workflow steps fail and follow their If it fails path. See AI Employees and AI settings.
I can't see a feature
There are three usual reasons:
- Your role. Menu items you can't use are hidden. For example, Workflows needs View workflows and Billing settings need Manage billing. Ask an organization owner or admin to check your role. See Team members, roles and access.
- The plan. If you see a box saying a feature "isn't included in your … plan", the workspace needs a plan that includes it. See Plans and billing.
- Not turned on. Some features and channels need setup by your Luminobot administrator first. If you don't see them, your administrator hasn't turned them on yet.
Also check you're in the right workspace: use the workspace menu at the top of the sidebar.
Emails aren't arriving
- Sign-up confirmation: on the Check your inbox page click Resend the email, or Use a different email if you mistyped it. The link works for 3 days.
- Team invitations: an admin can click Resend under Pending Invitations on Team Members. Invitations expire after 7 days.
- Notifications: click Notifications in the sidebar, then Preferences, and check that email is on for that event. Quiet hours and the daily digest also hold emails back.
Always check your spam or junk folder, and ask your IT team to allow emails from Luminobot.
Still stuck?
Contact your administrator. Tell them what you were doing, the workspace, the time, and the exact message you saw.