# Enviar cartão de contato

`POST /send/contact`

Pasta: **Enviar Mensagem**

## Autenticação

```http
token: {{token}}
```

## Descrição

# Enviar cartão de contato

Envia um cartão de contato (vCard) para o chat. Útil para compartilhar telefone e nome de uma pessoa.

## Endpoint

```http
POST {{baseUrl}}/send/contact
```

## Autenticação

Envie o token da instância no header:

```http
token: {{token}}
```

## Corpo da requisição

| Campo | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| number | string | Sim* | Destinatário do cartão |
| chatid | string | Sim* | Alternativa a number |
| displayName | string | Não | Nome exibido no cartão |
| name | string | Não | Alias de displayName |
| fullName | string | Não | Alias de displayName |
| phone | string | Não | Telefone do contato no vCard |
| phoneNumber | string | Não | Alias de phone |
| contact | string | Não | Alias de phone |
| vcard | string | Não | vCard completo (se omitido, a API monta a partir do nome/telefone) |

## Exemplo de Requisição

```bash
curl -X POST "{{baseUrl}}/send/contact" \
  -H "token: {{token}}" \
  -H "Content-Type: application/json" \
  -d '{"number": "{{remoteJid}}", "fullName": "João Silva", "phoneNumber": "5511999999999"}'
```

## Resposta de Sucesso

```json
{
  "success": true,
  "message": {
    "id": "3EB0A1B2C3D4E5F6",
    "timestamp": "2026-07-17T12:34:56Z",
    "sender": "5511888888888@s.whatsapp.net"
  }
}
```

## Erros comuns

- Destinatário ausente (`number`/`chatid`)
- Instância desconectada
- Token inválido

## Observações

- Se `vcard` estiver vazio, a API gera um vCard com `displayName`/`name`/`fullName` e o telefone informado (ou o próprio destinatário).

## Corpo (exemplo)

```json
{
  "number": "{{remoteJid}}",
  "fullName": "João Silva",
  "phoneNumber": "5511999999999"
}
```

## cURL

```bash
curl -X POST "{{baseUrl}}/send/contact" \
  -H "token: {{token}}" \
  -H "Content-Type: application/json" \
  -d '{
  "number": "{{remoteJid}}",
  "fullName": "João Silva",
  "phoneNumber": "5511999999999"
}'
```

---

[Índice da pasta](./index.md) · [Índice geral](../index.md) · [UI](https://gozap.dev/docs?op=enviar-mensagem/enviar-cartao-de-contato)