---
title: "Enviar"
method: POST
path: "/v1/message/send"
tags: ["Mensagens"]
---

# Enviar

`POST /v1/message/send`

Este endpoint segue as mesmas regras do canal de atendimento, por exemplo: uma conversa só pode ser iniciada no WhatsApp utilizando um modelo de mensagem.<br />Caso o contato não esteja cadastrado, ele será cadastrado automaticamente antes do envio.<br />O envio da mensagem será assincrono, ao enviar a mensagem será salva em uma fila de disparo, e será processada posteriormente.<br />Para verificar a situação do envio, consulte pelo endereço /chat/v1/message/{id}/status

## Request body

- PublicReqQuickSendMessageDTO
  - `from` string, nullable — Número de telefone do canal cadastrado na conta.
  - `to` string, required — Número de telefone do destinatário.
  - `botId` string, uuid, nullable — ID do bot que será ativado após a resposta do contato.
  - `body` PublicQuickSendBodyDTO, required
    - `text` string, nullable — Texto da mensagem a ser enviada. Obrigatório caso não seja informado o parâmetro `templateId` ou `fileUrl`.
    - `templateId` string, nullable — ID do modelo de mensagem para a mensagem a ser enviada. Obrigatório caso não seja informado o parâmetro `text` ou `fileUrl`.
    - `parameters` object, nullable — Parâmetros do modelo de mensagem. Obrigatório caso o modelo de mensagem informado no `templateId` possua parâmetros.
    - `fileUrl` string, nullable — URL pública de algum arquivo que deseja-se enviar na mensagem. O arquivo enviado deverá seguir as regras do canal de atendimento.
    - `fileId` string, uuid, nullable — Código do arquivo que deseja-se enviar na mensagem, o ID pode ser obtido nas rotas /core/v2/file, o arquivo deverá seguir as regras do canal de atendimento.
    - `refId` string, uuid, nullable — ID de referência para identificar a mensagem externamente como resposta a uma mensagem anterior.
  - `department` PublicQuickSendDepartmentDTO
    - `id` string, uuid, nullable — ID da equipe que deverá ser atribuída ao atendimento. Será utilizado somente caso seja criado um novo atendimento.
    - `name` string, nullable — Nome da equipe que deverá ser atribuída ao atendimento. Será utilizado somente caso seja criado um novo atendimento.
  - `user` PublicQuickSendUserDTO
    - `id` string, uuid, nullable — ID do atendente que deverá ser atribuído ao atendimento. Será utilizado somente caso seja criado um novo atendimento.
    - `phoneNumber` string, nullable — Telefone do atendente que deverá ser atribuído ao atendimento. Será utilizado somente caso seja criado um novo atendimento.
    - `email` string, nullable — Email do atendente que deverá ser atribuído ao atendimento. Será utilizado somente caso seja criado um novo atendimento.
  - `options` PublicQuickSendOptionsDTO
    - `enableBot` boolean, nullable — Determina se o chatbot deve ser ativado ao receber uma resposta do contato. Válido apenas caso um novo atendimento seja criado ao enviar a mensagem.
    - `hiddenSession` boolean, nullable — Determina se o atendimento deve estar oculto na tela. Válido apenas caso um novo atendimento seja criado ao enviar a mensagem. O atendimento passará a ser visível caso o contato responda.
    - `forceStartSession` boolean, nullable — Se um atendimento estiver em andamento, força o encerramento dele e inicia um novo.

## Response `200`

Success

- PublicQuickMessageDTO
  - `id` string, uuid
  - `createdAt` string, date-time, nullable
  - `updatedAt` string, date-time
  - `sessionId` string, uuid, nullable
  - `senderId` string, nullable
  - `status` 'PROCESSING' | 'SAVED' | 'QUEUED' | 'SENT' | 'DELIVERED' | 'READ' | 'FAILED' | 'DELETED' | 'WAIT_REPLY'
  - `statusUrl` string, nullable
  - `failureReason` string, nullable

## Other responses

- `500` — Server Error

---

[API](https://skmtc.net/helena/apis/core.md) · [All operations](https://skmtc.net/helena/apis/core/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/helena/core/revisions/811b2cdd2ec2/schema)