Public API

Queue a text message with a plain link

Same as POST /v1/messages, only for tools that cannot send headers; the key in a link can leak, so prefer POST /v1/messages. Link preview robots are redirected to the message link page and nothing is sent.

get/v1/send

Request

  • Base URL: https://otprun.com
  • URL: https://otprun.com/v1/send
  • Auth: HTTP bearer

Query parameters

tostring required

Recipient phone in international format such as +77010000000, or the name or alias of a saved contact

textstring required
api_keystring

The api key, for tools that can only open links; prefer the Authorization header

idempotency_keystring

Defaults to a hash of recipient and text, so reopening the same link within ten minutes does not send twice

Headers

Acceptstring
User-Agentstring

Response

OK

attemptsinteger required
bodystring required
channel'whatsapp_gateway' | 'telegram' | 'telegram_gateway' | 'whatsapp_official' required
contact_namestring required

Name of the recipient in the address book, empty if not saved

created_atstring date-time required
delivered_atstring date-time nullable required
edited_atstring date-time nullable required

When the text was last edited after sending, null if never

error_codestring required
error_detailstring required

The error WhatsApp returned on the last failed attempt, empty when there was none

failed_atstring date-time nullable required
idstring uuid required
outcome'delivered' | 'on_the_way' | 'retrying' | 'unconfirmed' | 'undecrypted' | 'not_delivered' required

What happened to the message in plain terms: unconfirmed means WhatsApp accepted it but the phone has not confirmed it for 10 minutes

project_idinteger required
purpose'notification' | 'otp' required
read_atstring date-time nullable required
revoked_atstring date-time nullable required

When the message was deleted for everyone, null if not

scheduled_atstring date-time required

Earliest moment the gateway sends the message

sent_atstring date-time nullable required
slot_idstring nullable required
status'queued' | 'sending' | 'sent' | 'delivered' | 'read' | 'failed' required
to_phonestring required

Changes

No recorded changes to this operation across all 1 revision of this API.