NODAPI

Enviar Mensagem

Enviar cartão de contato (vCard)

POST/send/contact
  • Conta no limite de envio da conexão. Ao passar do limite, a resposta é 429.

Autenticação: envie a chave da conexão no header token ou em Authorization: Bearer.

Envia um cartão de contato (vCard) para um contato ou grupo.

Recursos Específicos

  • vCard completo com nome, telefones, organização, email e URL
  • Múltiplos números de telefone (separados por vírgula)
  • Cartão clicável no WhatsApp para salvar na agenda
  • Informações profissionais (organização/empresa)

Campos Comuns

Este endpoint suporta todos os campos opcionais comuns documentados na tag "Enviar Mensagem", incluindo: delay, readchat, readmessages, replyid, mentions, forward, track_source, track_id, placeholders e envio para grupos.

Exemplo Básico

{
  "number": "5511999999999",
  "fullName": "João Silva",
  "phoneNumber": "5511999999999,5511888888888",
  "organization": "Empresa XYZ",
  "email": "[email protected]",
  "url": "https://empresa.com/joao"
}

Corpo da requisição (JSON)

CampoTipoDescrição
number*string

ID do chat para o qual a mensagem será enviada. Pode ser um número de telefone em formato internacional, um ID de grupo (@g.us), um ID de usuário (com @s.whatsapp.net ou @lid).

Exemplo: 5511999999999

fullName*string

Nome completo do contato

Exemplo: João Silva

phoneNumber*string

Números de telefone (separados por vírgula)

Exemplo: 5511999999999,5511888888888

organizationstring

Nome da organização/empresa

Exemplo: Empresa XYZ

emailstring

Endereço de email

Exemplo: [email protected]

urlstring

URL pessoal ou da empresa

Exemplo: https://empresa.com/joao

replyidstring

ID da mensagem para responder

Exemplo: 3EB0538DA65A59F6D8A251

mentionsstring

Números para mencionar (separados por vírgula)

Exemplo: 5511999999999,5511888888888

readchatboolean

Marca conversa como lida após envio

Exemplo: true

readmessagesboolean

Marca últimas mensagens recebidas como lidas

Exemplo: true

delayinteger

Atraso em milissegundos antes do envio, durante o atraso apacerá 'Digitando...'

Exemplo: 1000

forwardboolean

Marca a mensagem como encaminhada no WhatsApp

Exemplo: true

track_sourcestring

Origem do rastreamento da mensagem

Exemplo: chatwoot

track_idstring

ID para rastreamento da mensagem (aceita valores duplicados)

Exemplo: msg_123456789

asyncboolean

Se true, envia a mensagem de forma assíncrona via fila interna

Exemplo: false

* obrigatório

Respostas

  • 200Cartão de contato enviado com sucesso
  • 400Requisição inválida
  • 401Não autorizado
  • 429Limite de requisições excedido
  • 500Erro interno do servidor

Experimente

Atenção: a chamada é real. Ela roda na sua conexão e pode enviar mensagem de verdade. A chave fica só nesta tela e some ao sair dela; nunca é guardada.

Cole a chave gerada no painel.