# Inkbox troubleshooting

Fixes for texts, emails and calls that don't reach the bot, replies that don't arrive, and setup errors.

Canonical page: https://themachine.myapps.ai/docs/desktop/inkbox/troubleshooting

| What you see | What to do |
|---|---|
| Machine Desktop still says **Not connected** after setup | Click the **refresh** icon in **Channels**. If it still says so, check the web app shows Inkbox connected for this bot. |
| No Inkbox card on the web app's Channels page | Make sure you opened the right bot's **Settings → Channels**. Inkbox is on for every bot; there's nothing to switch on. If you only see *"Ask a workspace admin to connect Inkbox"*, you can't change this bot's channels; ask its owner or an admin. |
| *"This key has several Inkbox agents"* | Pick the agent this bot should be, then connect again. |
| *"already connected to another project"* | That Inkbox agent belongs to another bot. Disconnect it there, or use a different Inkbox agent. |
| You text by iMessage and nothing happens | Check your number is on the **Phone** list and shows **Connected** in **Manage**. If it says **Not connected yet**, send `connect @handle` to the Inkbox number first (see [Set up](/docs/desktop/inkbox/set-up)). |
| You send an SMS and nothing happens | SMS needs a phone number of the bot's own. Check your number is on the **Phone** list and the Inkbox agent has a number (Inkbox Console → **Phone**). Without one, use iMessage instead. |
| You email and nothing happens | Check your exact address, or its domain, is on the **Email** list. |
| The bot can't text you back by SMS | Text **START** to the bot's number once. A brand-new number needs 10–15 minutes before it can send texts. |
| The bot says it can't text someone | On the shared iMessage line, people must text the bot first. Ask them to send `connect @handle`. |
| Calls are answered but nothing happens after | Your number isn't on the **Phone** list, so the call never reaches the bot. |
| `/call` says it can't make calls | The bot has no Inkbox connection, or its Inkbox agent has no phone number. Without a number, the bot can only call people who connected to it over iMessage, not a business. |
| Replies stopped after you changed your Inkbox key | Click **Disconnect**, then connect again with the new key. |
| Group texts don't reach the bot | Only one-to-one texts reach the bot for now. |

Still stuck? The [full Inkbox reference](/docs/connect/inkbox#troubleshooting)
has more detail on each setting.