Skip to main content
POST
Send one Instagram DM as the creator, in answer to a person who wrote to them: the message the creator just read here and asked to send, sent word for word. Inside the 24-hour window since the person's last message it goes plain; past that window it goes under Meta's human agent tag, which Meta refuses until it grants Dally the Human Agent feature, so a conversation nobody has written into for a day cannot be answered here yet. The answer's tag says which one Meta took. Call it only for a message the creator asked to send in this conversation, and never for a rule, a schedule or a message nobody read; automation.arm is the way a keyword answers by itself. The creator turns approved sends on in Dally's settings, and until they do this is refused.

Authorizations

Authorization
string
header
required

A WorkOS-dashboard-issued internal API key on Authorization: Bearer.

Body

application/json
platform_account_id
string
required

The person's Instagram-scoped id, from the DM you are answering: touchpoints, kind dm, platform_account_id. Never a handle, never a display name.

Required string length: 1 - 64
text
string
required

The message as the creator approved it, at most 1000 Unicode code points. It is sent exactly as written: Dally adds no link and no disclosure.

Required string length: 1 - 1000
request_id
string<uuid>
required

A UUID you mint for this one send. The same id twice sends one message, so carry the same id into a retry and mint a fresh one for a new message.

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
connection_id
string<uuid>

The Instagram connection to send from. Omit it and Dally sends from the creator's live one, which is what every room with one account has.

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$

Response

Success. request_id is present on every response.

sent
object
required

One DM Dally sent as the creator because the creator read it here and asked for it.

show
object
required

How it is shown: dally_write renders the sent message on this very answer with this whole response as its data, so the creator already sees what went; do not render it again.

request_id
string
required

Server-minted id for this request. Present on every response, success and error — quote it when reporting a problem.

Minimum string length: 1