Enviar Mensagem
Enviar cartão de contato (vCard)
/send/contactConta 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)
| Campo | Tipo | Descriçã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 ( 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 |
| organization | string | Nome da organização/empresa Exemplo: Empresa XYZ |
| string | Endereço de email Exemplo: [email protected] | |
| url | string | URL pessoal ou da empresa Exemplo: https://empresa.com/joao |
| replyid | string | ID da mensagem para responder Exemplo: 3EB0538DA65A59F6D8A251 |
| mentions | string | Números para mencionar (separados por vírgula) Exemplo: 5511999999999,5511888888888 |
| readchat | boolean | Marca conversa como lida após envio Exemplo: true |
| readmessages | boolean | Marca últimas mensagens recebidas como lidas Exemplo: true |
| delay | integer | Atraso em milissegundos antes do envio, durante o atraso apacerá 'Digitando...' Exemplo: 1000 |
| forward | boolean | Marca a mensagem como encaminhada no WhatsApp Exemplo: true |
| track_source | string | Origem do rastreamento da mensagem Exemplo: chatwoot |
| track_id | string | ID para rastreamento da mensagem (aceita valores duplicados) Exemplo: msg_123456789 |
| async | boolean | 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.