Enviar notificação via SMS

POST 
/v1/notifications/sms

Envia uma mensagem de texto (SMS) para o número de telefone informado

Request

application/json

Body

smsobjectrequired
to stringrequired
Número de telefone do destinatário. Pode ser informado com ou sem o código do país (DDI), caso não informado, será considerado o DDI do Brasil (+55)
Possible values: Value must match regular expression ^(\+[1-9]{1,2})?\d{10,11}$
Example: +5511912345678
from string
Remetente, caso aceito pela operadora
Example: Base39
text stringrequired
Mensagem a ser enviada
Example: Olá, mundo!

Responses

202

Retorna quando a mensagem foi aceita, sem confirmar o envio da notificação.

application/json

Schema

Schema

message stringrequired

Mensagem de retorno

messageId stringrequired

Identificador da mensagem

Example (from schema)

{
  "message": "string",
  "messageId": "string"
}

400

Retorna quando ocorre um erro no envio da mensagem.

application/json

Schema

Schema

type string
error
Possible values: [error]
Example: error
status int32
O status HTTP da resposta
Example: 400
code string
Um código de erro específico da Base39
Possible values: [created, accepted, no_content, redirect, not_modified, bad_request, unauthorized, forbidden, not_found, method_not_allowed, conflict, precondition_failed, too_many_requests, internal_server_error, unavailable, item_name_invalid, insufficient_scope]
Example: item_name_invalid
message string
Uma breve descrição do erro
Example: Method Not Allowed

context

object

Um objeto de formato livre que contém contexto adicional sobre o erro. Os campos possíveis são definidos por endpoint. message é apenas um exemplo.

message string

More details on the error.

Example: Something went wrong.
help string
Um URL com links para mais informações sobre o motivo da ocorrência desse erro.
Example: https://docs.paketa.com.br/development/first-steps/errors
request string
Um identificador exclusivo para esta resposta, que pode ser usado ao entrar em contato com o suporte da Base39.
Example: abcdef123456

Example (from schema)

{
  "type": "error",
  "status": 400,
  "code": "item_name_invalid",
  "message": "Method Not Allowed",
  "context": {
    "message": "Something went wrong."
  },
  "help": "https://docs.paketa.com.br/development/first-steps/errors",
  "request": "abcdef123456"
}

Loading...