> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oxenty.api.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Enviar Contato

> Envia um cartão de contato (vCard)

Envia um cartão de contato para um número WhatsApp.

## Request Body

<ParamField body="sessionId" type="string" required>
  ID da sessão WhatsApp.
</ParamField>

<ParamField body="to" type="string" required>
  Número do destinatário ou JID de grupo.
</ParamField>

<ParamField body="displayName" type="string" required>
  Nome de exibição do contato.
</ParamField>

<ParamField body="phoneNumber" type="string" required>
  Número de telefone do contato.
</ParamField>

<ParamField body="organization" type="string">
  Organização/empresa do contato (opcional).
</ParamField>

## Resposta

<ResponseField name="messageId" type="string">
  ID único da mensagem enviada.
</ResponseField>

<RequestExample>
  ```bash cURL theme={"system"}
  curl -X POST "https://api.oxenty.api.br/api/messages/vcard" \
    -H "X-API-Key: YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "sessionId": "550e8400-e29b-41d4-a716-446655440000",
      "to": "5511999999999",
      "displayName": "João Silva",
      "phoneNumber": "+5511988887777",
      "organization": "Oxenty"
    }'
  ```

  ```typescript TypeScript theme={"system"}
  const result = await client.messages.sendVCard({
    sessionId: '550e8400-e29b-41d4-a716-446655440000',
    to: '5511999999999',
    displayName: 'João Silva',
    phoneNumber: '+5511988887777',
    organization: 'Oxenty',
  });
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={"system"}
  {
    "messageId": "3EB0A1B2C3D4E5F6",
    "status": "sent"
  }
  ```
</ResponseExample>

***

## Enviar Múltiplos Contatos

<api method="POST" path="/api/messages/vcards" />

Envia múltiplos cartões de contato em uma única mensagem.

```bash theme={"system"}
curl -X POST "https://api.oxenty.api.br/api/messages/vcards" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sessionId": "550e8400-e29b-41d4-a716-446655440000",
    "to": "5511999999999",
    "displayName": "Contatos Oxenty",
    "contacts": [
      { "displayName": "João Silva", "phoneNumber": "+5511988887777" },
      { "displayName": "Maria Santos", "phoneNumber": "+5511977776666" }
    ]
  }'
```