Developer docs

IotaBot Chat API

Your website chat, in your code: every message in, live replies out.

Get an API key

Live chat API error codes

Branch on error.code.

CodeStatusWhat to do
conversation_closed422Website chats accept messages only while open; reopen a conversation before changing its mode.
conversation_not_found404No conversation with that id that this key can see.
text_required400The message has no content for its channel (text, html, a template or attachments).
integration_paused409An agent paused integration replies on this conversation. Stop retrying; a conversation.updated event tells you when it resumes.
website_not_allowed403The key is limited to other websites.
agent_not_found422assigned_agent_id is not an active agent in this workspace.
idempotency_key_reused422The Idempotency-Key was already used with a different request.
idempotency_in_progress409A request with this Idempotency-Key is still being processed. Retry shortly.