Skip to main content
POST
/
v1
/
messages
/
send
Enviar mensagem de texto
curl --request POST \
  --url https://api.nuvia.ai/v1/messages/send \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "conversationId": "<string>",
  "message": {
    "content": "<string>",
    "attachment": "<string>"
  },
  "followup": "<string>"
}
'
{
  "content": "<string>",
  "conversation": "<unknown>",
  "inbox": "<unknown>",
  "contact": "<unknown>",
  "company": "<unknown>",
  "_id": "<string>",
  "additional_attributes": "<unknown>",
  "source_id": "<string>",
  "user": "<unknown>",
  "attachments": [
    "<unknown>"
  ],
  "errors": [
    {
      "code": "<string>",
      "title": "<string>",
      "message": "<string>"
    }
  ],
  "createdAt": "<unknown>",
  "updatedAt": "<unknown>"
}

Authorizations

​
Authorization
string
header
required

Token JWT de autenticação

Headers

​
x-company-id
string

Identificador da empresa-alvo. Obrigatório apenas para API Keys globais (type=global). Ignorado para API Keys de empresa e usuários humanos.

Body

application/json
​
conversationId
string
required

ID da conversa

​
message
object
required
​
followup
string

ID do follow-up (opcional)

Response

Mensagem enviada com sucesso

​
content
string
required

Conteúdo da mensagem

​
content_type
enum<string>
required

Tipo de conteúdo: TEXT, IMAGE, AUDIO, VIDEO, DOCUMENT, TEMPLATE, etc.

Available options:
TEXT,
CARDS,
AUDIO,
VIDEO,
IMAGE,
DOCUMENT,
CONTACTS,
LOCATION,
TEMPLATE,
STICKER,
UNSUPPORTED
​
message_type
enum<string>
required

Tipo de mensagem: INCOMING, OUTGOING, ACTIVITY

Available options:
INCOMING,
OUTGOING,
ACTIVITY
​
status
enum<string>
required

Status da mensagem: SENT, DELIVERED, READ, FAILED

Available options:
SENT,
DELIVERED,
READ,
FAILED
​
conversation
any
required

Conversa associada à mensagem

​
inbox
any
required

Inbox da mensagem

​
contact
any
required

Contato da mensagem

​
company
any
required

Empresa da mensagem

​
_id
string

ID da mensagem

​
additional_attributes
any

Atributos adicionais da mensagem

​
sender_type
enum<string>

Tipo do remetente: CONTACT, USER, BOT, SYSTEM

Available options:
CONTACT,
USER,
BOT,
SYSTEM
​
source_id
string

ID da mensagem na plataforma externa

​
user
any

Usuário que enviou a mensagem

​
attachments
any[]

Anexos da mensagem

​
errors
object[]

Lista de erros associados à mensagem

​
createdAt
any

Data de criação da mensagem

​
updatedAt
any

Data de atualização da mensagem