tebarDocs
GuidePlatformsDevelopersAPI ReferenceChangelog
Inbox

Show "typing…" to the customer

POST
/v1/inbox/conversations/{id}/typing

typing: true shows "typing…" from the account in the conversation, false hides it; a message sent ends it too. Instagram shows it only while the customer is signed in. Best effort: 204 even when Instagram does not take it. At most 60 a minute per user (429 rate_limited).

Requires the write scope.

Authorization

bearer
headerAuthorizationBearer <token>

An API key (tb_live_...) from the dashboard, or an OAuth access token.

Path Parameters

id*string
Formatuuid

Header Parameters

Tebar-Profile?string

Limits an owner key to one profile (id or external_id). Unknown: 404 profile_not_found.

Request Body

application/json
  1. body
typing*boolean

Response Body

Sent to Instagram.

Example Request
curl -X POST 'https://api.tebar.app/v1/inbox/conversations/497f6eca-6276-4993-bfeb-53cbbbba6f08/typing' \
  -H 'Content-Type: application/json' \
  -d '{
  "typing": true
}'
Example Response
Empty

Send a DM POST

Queued and sent by Tebar within seconds; the messages come back pending, and GET …/messages shows them sent, failed or unknown. Instagram allows replies only within 24 hours of the customer's last message (422 messaging_window_closed). text: up to 1,000 bytes. media_ids from the media library: JPG/PNG up to 8 MB (up to 10 go as one message), MP4/MOV up to 25 MB (one message each); they go before the text (422 attachment_unsupported, attachment_too_large). buttons (1-3, text up to 640 characters; Instagram's button template) or quick_replies (1-13, shown on phones only), not both, and only with text. A tap on a postback button or a quick reply comes back as a message of kind postback or quick_reply with postback { title, payload }, and in the message.received webhook. cards (1-10, Instagram's generic template; one card alone, 2-10 as a carousel scrolled sideways): each a title (up to 80 characters) and at least one of subtitle (80), media_id (JPG/PNG from the media library) or image_url (public https), default_action { url } and 1-3 buttons. Sent after the media and the text as a message of kind cards; not with buttons or quick_replies. Shown in the Instagram phone app only. An image Instagram cannot fetch gives no error: the card goes out without it (400 invalid_image_url for a private or non-https address). Also 422 messaging_permission_missing. At most 60 a minute per user. Requires the write scope.

Send a failed DM again POST

Only an outgoing message that failed or is unknown (409 message_not_retryable). Check in Instagram first that an unknown one did not go out. Requires the write scope.