Developer docs

IotaBot Instagram API

Every DM and comment on your webhook. Reply from your code.

Get an API key

Instagram API error codes

Branch on error.code.

CodeStatusWhat to do
window_closed422More than 24 hours since the customer last wrote. On WhatsApp send an approved template; on Instagram you must wait for them to write.
recipient_opted_out422The customer opted out of this channel (they replied STOP, or the contact is marked opted out). Nothing can be sent to them there.
unsupported_attachment400Instagram takes images, video and audio only.
text_required400The message has no content for its channel (text, html, a template or attachments).
conversation_not_found404No conversation with that id that this key can see.
integration_paused409An agent paused integration replies on this conversation. Stop retrying; a conversation.updated event tells you when it resumes.
api_quota_exceeded429The workspace used its monthly API messages. It resets on the 1st; the plan sets the limit.
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.