ZapFácil zapfacil.dev Doc
Entrar Painel
Doc AI Friendly (agente de IA)

Enviar Texto

Envia uma mensagem de texto simples para um número de WhatsApp. Você pode utilizar a formatação padrão do WhatsApp para enriquecer suas mensagens (como *negrito*, _itálico_, ~tachado~ ou `monoespaçado`).

Você também pode utilizar quebra de linhas em suas mensagens, porém isso pode ser feito de formas diferentes dependendo da plataforma que sua aplicação está rodando ou da linguagem de programação utilizada. O ZapFácil suporta as sequências \n, \r, \r\n e %0a.

Sobre emojis: um emoji é um caractere UTF-8 normal (ASCII). Você pode enviá-los diretamente no corpo da mensagem ou utilizando sua representação unicode. Recomendamos garantir que sua aplicação utilize UTF-8 para evitar problemas de codificação. 🚀

POST /instances/{instance_id}/send-text
Exemplo Completo (Payload) 
{
  "phone": "5511999999999",
  "message": "Olá! Esta é uma mensagem de teste.\nCom quebra de linha.",
  "delayTyping": 3,
  "delayBetweenMessages": 2
}

Headers

X-Instance-Token string header required

Token secreto exclusivo da instância.

Body Payload

application/json
phone string required

Número do destinatário com DDI e DDD (apenas números).

message string required

Texto da mensagem a ser enviada. (Máx: 4096 caracteres)

delayTyping integer

Simula digitação ('digitando...') em segundos antes do envio. (Mín: 1, Máx: 15)

delayBetweenMessages integer

Tempo de envio entre as mensagens. (Mín: 1, Máx: 15)

Response Schema

application/json
success boolean required

Indica se a requisição foi aceita.

error string | null required

Detalhes de falhas (null em caso de sucesso).

data object | null

Informações do envio (pode ser null em alguns casos).

Atributos do Objeto
zapFacilId string (uuid)

Identificador único da mensagem no ZapFácil.

whatsappId string

ID da mensagem gerado na rede do WhatsApp.

{
  "success": true,
  "data": {
    "zapFacilId": "019e059f-d16a-7bf1-a1b6-26293e8a05f1",
    "whatsappId": "3EB0BC9B8E580F7E607"
  },
  "error": null
}