Help Centre / Troubleshooting connections

Troubleshooting connections

Common provider errors, what they mean, and how to fix them.

When a connection fails, the setup screen shows the cause and the fix. This page lists the most common ones. The error code shown on the screen helps support find the problem quickly.

General

MessageWhat to do
The sign-in link expiredThe sign-in took more than 10 minutes or was opened elsewhere. Start it again from the same step.
The sign-in was closedThe provider’s window closed early. Start again; allow pop-ups for PALMS if it didn’t open.
The provider couldn’t be reachedCheck your internet connection and retry in a minute.
Already connectedOpen the channel in Settings → Channels; use Reconnect if it needs new credentials.
Connected to another organizationDisconnect it there first, or contact PALMS support.

WhatsApp, Messenger and Instagram (Meta)

CodeMeaningFix
190The access token is no longer validLog in with Facebook again, or create a permanent system-user token.
10, 200–299Permission missing or no access to the accountGive the system user Full control of the WhatsApp account; generate the token with both WhatsApp permissions.
100Meta doesn’t recognise the detailsCopy the IDs again (digits only).
4, 80007Too many requestsWait a few minutes and retry.
368, 131031The account is restricted or lockedSee Account quality in WhatsApp Manager; check the two-step PIN.
133005Wrong two-step verification PINTurn two-step verification off for the number, or reset the PIN.
133006The number isn’t verified yetVerify it with the SMS or call code.
133010The number isn’t registeredUse the guided connection, or register it in WhatsApp Manager.
133015, 133016Recently deleted, or too many attemptsWait (5 minutes, or a few hours) and retry.
2655093Already shared with a partnerAsk the previous provider to remove their access; turn two-step verification off.
2593109Chat history sharing was declined on the phoneNothing to fix: new messages still arrive. To import the history, disconnect and connect again, and accept sharing in the app.

Messages from the Facebook login (Embedded Signup)

MessageMeaningFix
The Facebook login expiredMeta’s one-time code is valid 30 seconds and only onceClick Continue with Facebook again and finish in one go.
No number was sharedThe window finished without a number (only the account was created)Start again and add or choose the number in Meta’s window.
A different account or number was returnedThe account or number isn’t one Meta shared with PALMSStart again and pick the same account and number in Meta’s window.
The pop-up was blockedThe browser blocked Meta’s windowAllow pop-ups for PALMS (icon in the address bar) and try again.
Facebook’s login couldn’t loadAn ad blocker, privacy extension or network blocks facebook.comTurn the blocker off for PALMS, or try another browser or network.
Log in with Facebook isn’t switched onThe PALMS server has no Meta app settingsAsk your administrator, or use the Advanced connection.

Website chat

ProblemLikely causeFix
The bubble doesn’t appearThe code isn’t published yet, or a cache serves the old pagePublish the site in your website builder, clear the cache (plugin, CDN), then refresh.
The bubble doesn’t appear on one addressThe address isn’t in the chat’s listEdit chat → Your website: add the address (for example yourshop.cm).
“This chat isn’t available on this website” in the browser consoleSame as above: the page’s address isn’t allowedAdd the address to the chat’s list.
The bubble appears for you but not for some visitorsAn ad blocker or privacy extension blocks the chatNothing to fix on your side; most visitors aren’t affected.
PALMS says “Not installed yet”No visitor has loaded the chat on your website since you pasted the codeOpen your website yourself; PALMS notices within a few seconds.
Your replies don’t reach the visitorThe visitor closed the pageThey see your replies when they come back on the same browser. Ask for an email in the pre-chat form to reply later.

Telegram

CodeMeaningFix
401The bot token isn’t recognisedIn BotFather: /mybots → your bot → API Token; copy it again.
404The token is incompleteCopy the whole token again, from the digits to the last character.
400Telegram refused the request (often PALMS’s address for the bot’s messages)Retry in a minute; if it persists, contact PALMS support.
403The customer blocked the botNothing to fix; they can tap Restart in the bot to write again.
409Another program uses this botStop it, or revoke the token in BotFather and use the new one.
429Too many requestsWait a minute and retry.
Token for another botReconnect was given a different bot’s tokenUse the token of the bot connected to this channel, or connect the other bot as a new channel.
Can’t reach this PALMS serverThe server has no public https:// addressYour administrator sets PUBLIC_API_URL (https).
Messages stopped arrivingAnother tool took over the bot (Telegram delivers to one place only)Reconnect the channel; stop the other tool first.

Messenger and Instagram

MessageMeaningFix
No Page was sharedNo Page was ticked in Facebook’s window, or the account manages no PageContinue with Facebook again, choose Edit access and tick the Page.
No Instagram account was foundThe account isn’t professional, isn’t linked to the Page, or wasn’t tickedSwitch to a professional account, link it to the Page (Edit profile → Page), then log in again.
You can’t message as this PageYour role on the Page doesn’t include messagingAsk a Page admin for full control or Messages access.
This channel’s Page wasn’t sharedOn reconnect, the channel’s Page wasn’t tickedContinue with Facebook, Edit access, tick the same Page and Instagram account.
The Facebook login expiredThe Pages were chosen more than an hour after logging inContinue with Facebook again and choose straight away.
230The Page’s messaging permission was turned off in Facebook’s windowContinue with Facebook again and keep every permission ticked.
190The Page’s access is no longer valid (password changed, role lost, PALMS removed)Reconnect the channel with an account that manages the Page.
551This person isn’t available right nowNothing to fix; they can write to you again.
10 / 2018278 / 2534022Outside the 24-hour windowWait for the customer to write again.
Only your team gets answersPALMS’s Meta app is in development mode or waiting for App ReviewExpected until approval; see Approvals.
No Instagram messages arrive“Allow access to messages” is off in InstagramInstagram → Settings → Messages and story replies → Message controls → turn it on.

SMS (Africa’s Talking, Twilio)

ErrorMeaningFix
Invalid API keyWrong key or username, or sandbox vs live mismatchThe sandbox username is “sandbox”; generate the key in the same environment.
InvalidSenderIdSender ID not approvedRequest it in Africa’s Talking, or leave it empty.
InsufficientBalanceNot enough creditTop up the account.
Twilio 20003Wrong Account SID or Auth TokenCopy them again from the Twilio Console.
Twilio 21211, 21614Invalid or non-mobile numberUse a mobile number in international format.
Twilio 21608Trial accountVerify your number in Twilio, or upgrade.
Twilio 21610The number replied STOPUse another phone; reply START to subscribe again.
InvalidPhoneNumberAfrica’s Talking can’t read the numberUse international format with the country code, e.g. +254 712 345 678.
UserInBlacklistThe person opted out of promotional SMSUse another phone for the test.
CouldNotRouteNo route to that network, or sender ID not approved thereTry another network, or ask Africa’s Talking support.
Twilio 20404Number or account not foundClick Find my numbers again and choose one.
Twilio 21606, 21408The number can’t send to that country, or the country is turned offBuy a local number; tick the country in Messaging → Settings → Geo permissions.
No replies arrive (Africa’s Talking)Callback URLs not pasted, or you send with a sender ID onlyPaste both addresses in SMS → SMS Callback URLs; replies need a short code. See SMS → callbacks.

Email (Google, Microsoft)

ErrorMeaningFix
access_deniedSign-in cancelled or permission not tickedTry again and allow reading and sending email.
invalid_grantAuthorisation revoked or expiredSign in again.
AADSTS65001Your Microsoft 365 administrator must approve PALMSAsk them to grant consent.
AADSTS50020Account from another directorySign in with the mailbox’s own work account.
AADSTS90094Only an administrator can approve PALMSSee administrator approval.
admin_policy_enforcedGoogle Workspace blocks unapproved appsAsk your administrator to allow PALMS.
Password refused (IMAP)Wrong password, or an app password is requiredCreate an app password.
IMAP switched offThe provider disables IMAP by defaultSwitch it on in the webmail’s settings.
Secure connection failedPort and SSL don’t match993 with SSL (IMAP); 465 with SSL or 587 without (SMTP).
Use Continue with MicrosoftOutlook.com and Microsoft 365 refuse passwords from other appsChoose Outlook and sign in with Microsoft.

TikTok

ErrorMeaningFix
Region not eligibleAccounts registered in the EEA, Switzerland or the UK can’t use Business MessagingUse an eligible TikTok Business Account.
access_deniedSign-in cancelled or permission refusedTry again and allow all permissions.
Not a Business AccountPersonal and Creator accounts can't use business messagingIn the TikTok app: Settings and privacy → Account → Switch to Business Account.
Permission missing (scope)A permission was unticked on TikTok's screenConnect again and leave every permission ticked.
40001 No permissionPALMS's TikTok app isn't approved for this account yet, or the account isn't eligibleCheck the account type and region; then contact PALMS support.
40100 Too many requestsTikTok's rate limitWait a minute and try again.
40105 / Sign-in expiredAccess removed in TikTok, or unused for 30 daysReconnect with the same account.
invalid_grantThe code from TikTok expired or was reusedStart the sign-in again.
Reply window closedMore than 48 hours since the customer's last message, or 10 replies already sentWait for the customer to write again.
Customers can't message youDirect messages limited to friends or followersTikTok app: Privacy → Direct messages → Everyone.

LINE

ErrorMeaningFix
401 Access token refusedThe channel access token is wrong, was reissued, or belongs to another channelIn the LINE Developers console, open the Messaging API tab, issue the long-lived token again, and paste the whole token.
LINE couldn’t reach PALMSLINE got no answer from the webhook address, or the channel secret doesn’t matchCheck that the Channel secret is the one on the Basic settings tab, then retry.

Viber

ErrorMeaningFix
2 Token refusedThe bot token is wrong, or the bot was deleted or isn’t active yetCopy the token again from the bot’s page in Viber Partners. If the bot awaits Viber’s approval, wait for it, then retry.
Webhook not setViber checks the address by calling it, and the check failedRetry in a minute. If it keeps failing, the PALMS server may not be reachable over https: contact support.

Discord

ErrorMeaningFix
401 Bot token refusedThe token is wrong or was reset after you copied itIn the Developer Portal, open your application → Bot, click Reset Token, and paste the new token.

Voice calls

ErrorMeaningFix
Number not in the accountThe number isn’t one of the account’s numbers, or it can’t take callsEnter the number exactly as the provider shows it (with + and the country code), or buy a number with voice.
Can’t receive from this provider yetThe server has no public https:// addressYour administrator sets PUBLIC_API_URL (https).

The test message didn’t arrive

  1. Check you sent the exact code, to the right number or account.
  2. Wait a minute: some providers deliver with a short delay.
  3. WhatsApp: in WhatsApp Manager, check the number’s status is Connected. With the Advanced connection, the PALMS Meta app must be subscribed to your account (PALMS does this when connecting; Test on the channel rechecks it).
  4. Press Test on the channel in Settings → Channels: it shows the last time the provider contacted PALMS.
  5. Still nothing? Skip the test and contact support with the channel name and the time you sent the message.

Still stuck?

Our team answers on WhatsApp, in English or French.

WhatsAppOpen Graphwafe