ChatAman Docsby CodeEra
العربية Open app

Documentation

Troubleshooting AI assistant connections

What each ChatAman MCP error means and what to do, plus answers to common questions about connecting assistants.

Common errors

Error Meaning What to do
invalid_token (HTTP 401) The token is missing, expired or revoked Sign in again or create a new token
SCOPE_REQUIRED The connection doesn’t have this permission Choose Edit permissions on the connection
PERMISSION_DENIED Your ChatAman role doesn’t allow it Ask an organization owner to update your role
TWO_FA_REQUIRED Publishing needs a recent confirmation Confirm with a code in AI assistants, or enable autonomous publishing
APPROVAL_REQUIRED The post or reply needs a person’s approval Approve it in ChatAman, then retry
POST_VERSION_CONFLICT The post changed since the assistant read it Read the post again, then retry
RECONNECT_REQUIRED The social account must be reconnected Reconnect the account in ChatAman
PLATFORM_NOT_ENABLED This platform isn’t enabled for assistant publishing yet Publish from ChatAman directly
PUBLISHING_PAUSED Publishing is paused for the organization Resume publishing in content settings
IDEMPOTENCY_CONFLICT The same key was used with different input Use a new idempotency key
RECONCILIATION_REQUIRED The platform’s answer was unclear Check the post in ChatAman before trying again
RATE_LIMITED Too many requests Wait and retry

Questions

Does the assistant see my password or confirmation codes? No. You sign in on the ChatAman page, and codes are entered only in ChatAman.

Can the assistant reach another organization? No. Each connection is fixed to one organization. Data from other organizations is reported as not found.

Which platforms can an assistant publish to? Facebook and Instagram, for accounts whose publishing capability is ready. Other platforms are available for reading and drafts.

I enabled autonomous publishing but the assistant still asks for a code. Check the connection card: the period may have ended, today’s limit may be reached, or the post targets an account outside the chosen accounts.

How do I stop everything at once? Choose Revoke on the connection. Access stops immediately, and posts it scheduled return to draft.