Enviar Texto

Enviar mensagem de texto simples

POST /messages/text

cURL

curl -X POST https://zapclass.com.br/api/messages/text \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer zc_6FrX2qjM4bHT9pR6cC0sD8wLkG3nE2tZfV5uN1aP" \
  -d '{
    "number": "5511999999999",
    "message": "Olá! Confira nossas novidades em https://zapclass.com.br",
    "delay": 3000,
    "forward": true,
    "link_preview": true,
    "link_preview_title": "Novidade! Loja online com frete grátis em todo o Brasil",
    "link_preview_description": "Aproveite promoções exclusivas e receba seus produtos sem custo de entrega.",
    "link_preview_image": "https://placehold.co/600x400.png",
    "link_preview_large": true,
    "message_repy_id": "5511999999999:1AB2C3DEFG4H56I78JKL9M",
    "message_source": "typebot",
    "message_id": "5511999999999:1AB2C3DEFG4H56I78JKL9M",
    "mentions": "5511999999999,5511888888888",
    "read": true,
    "read_messages": true
  }'

200

{
  "success": true,
  "id": "5511999999999:1AB2C3DEFG4H56I78JKL9M",
  "chat_id": "[e-mail]"
}

Authorization

api_key · string · required

Chave de autenticação da sua conexão, utilizada no header Authorization como Bearer Token.
Você encontra sua API Key no botão API da sua conexão no painel ZapClass.
A chave sempre começa com o prefixo zc_.
Exemplo: zc_6FrX2qjM4bHT9pR6cC0sD8wLkG3nE2tZfV5uN1aP

Body Parameters

number · string · required

Número do destinatário no formato internacional.
Deve incluir código do país DDI + DDD + número.
Exemplo: 5511999999999

message · string · required

Conteúdo da mensagem de texto a ser enviada.
Suporta texto simples, emojis e caracteres especiais.
Exemplo: Olá! Bem-vindo à nossa plataforma ZapClass

delay · integer

Atraso em milissegundos antes do envio (agendamento).
Útil para envios programados ou intervalos entre mensagens.
Aparecerá “Digitando…” antes do envio.
Exemplo: 3000

forward · boolean

Marca a mensagem como encaminhada para o destinatário.
Exemplo: true

link_preview · boolean

Controla se links na mensagem devem exibir prévia automática.
true: exibe prévia, false: apenas o link.
Exemplo: true

link_preview_title · string

Título personalizado para prévia de link.
Se fornecido, será exibido como o título da prévia do link.
Limite: 60 caracteres
Exemplo: Novidade! Loja online com frete grátis em todo o Brasil

link_preview_description · string

Descrição personalizada para prévia de link.
Se fornecido, será exibido como a descrição da prévia do link.
Limite: 80 caracteres
Exemplo: Aproveite promoções exclusivas e receba seus produtos sem custo de entrega.

link_preview_image · string

URL ou Base64da imagem personalizada para prévia de link.
Se fornecido, será exibido como a imagem da prévia do link.
Exemplo: https://placehold.co/600x400.png

link_preview_large · boolean

Controla se a prévia de link deve ser exibida em tamanho grande.
true: exibe em tamanho grande, false: exibe em tamanho padrão
Exemplo: true

message_reply_id · string

Identificador da mensagem para responder.
Exemplo: 5511999999999:1AB2C3DEFG4H56I78JKL9M

message_source · string

Origem do envio da mensagem.
Normalmente usado para rastreamento da mensagem.
Exemplo: typebot

message_id · string

Identificador do envio da mensagem.
Combinado com o message_source pode ser usado para rastreamento.
Exemplo: 5511999999999:1AB2C3DEFG4H56I78JKL9M

mentions · string

Relação de números de telefone a serem mencionados na mensagem.
O números devem ser separads por vírgula.
Exemplo: 5511999999999,5511888888888

read · boolean

Marca a conversa como lida após o envio.
Exemplo: true

read_messages · boolean

Marca as últimas mensagens como lidas após o envio.
Exemplo: true

cURL

curl -X POST https://zapclass.com.br/api/messages/text \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer zc_6FrX2qjM4bHT9pR6cC0sD8wLkG3nE2tZfV5uN1aP" \
  -d '{
    "number": "5511999999999",
    "message": "Olá! Confira nossas novidades em https://zapclass.com.br",
    "delay": 3000,
    "forward": true,
    "link_preview": true,
    "link_preview_title": "Novidade! Loja online com frete grátis em todo o Brasil",
    "link_preview_description": "Aproveite promoções exclusivas e receba seus produtos sem custo de entrega.",
    "link_preview_image": "https://placehold.co/600x400.png",
    "link_preview_large": true,
    "message_repy_id": "5511999999999:1AB2C3DEFG4H56I78JKL9M",
    "message_source": "typebot",
    "message_id": "5511999999999:1AB2C3DEFG4H56I78JKL9M",
    "mentions": "5511999999999,5511888888888",
    "read": true,
    "read_messages": true
  }'

200

{
  "success": true,
  "id": "5511999999999:1AB2C3DEFG4H56I78JKL9M",
  "chat_id": "[e-mail]"
}