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

# Enviar Contato

> Envia uma mensagem com informações de contato via WhatsApp.

## Parâmetros

### Body

<ParamField body="messaging_product" type="string" required default="whatsapp">
  Sempre `"whatsapp"`.
</ParamField>

<ParamField body="to" type="string" required>
  Número do destinatário no formato `wa_id`.
</ParamField>

<ParamField body="type" type="string" required default="contacts">
  Sempre `"contacts"`.
</ParamField>

<ParamField body="context" type="object">
  Para responder uma mensagem específica.

  <Expandable title="Campos">
    <ParamField body="context.message_id" type="string" required>
      ID da mensagem a ser respondida.
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="contacts" type="array" required>
  Array de objetos de contato.
</ParamField>

## Exemplo

```json theme={null}
{
  "messaging_product": "whatsapp",
  "to": "5511999999999",
  "type": "contacts",
  "contacts": [
    {
      "addresses": [
        {
          "street": "Av. Paulista, 1000",
          "city": "São Paulo",
          "state": "SP",
          "zip": "01310-100",
          "country": "Brasil",
          "country_code": "BR",
          "type": "WORK"
        }
      ],
      "birthday": "1990-05-15",
      "emails": [
        {
          "email": "contato@empresa.com",
          "type": "WORK"
        }
      ],
      "name": {
        "formatted_name": "João Silva",
        "first_name": "João",
        "last_name": "Silva"
      },
      "org": {
        "company": "Empresa LTDA",
        "department": "Vendas",
        "title": "Gerente"
      },
      "phones": [
        {
          "phone": "+5511999999999",
          "wa_id": "5511999999999",
          "type": "WORK"
        }
      ],
      "urls": [
        {
          "url": "https://empresa.com",
          "type": "WORK"
        }
      ]
    }
  ]
}
```

### Campos do Contato

| Campo                      | Tipo   | Descrição                       |
| -------------------------- | ------ | ------------------------------- |
| `name.formatted_name`      | string | Nome formatado (obrigatório)    |
| `name.first_name`          | string | Primeiro nome                   |
| `name.last_name`           | string | Sobrenome                       |
| `name.middle_name`         | string | Nome do meio                    |
| `name.prefix`              | string | Prefixo (Sr., Dr.)              |
| `name.suffix`              | string | Sufixo (Jr., III)               |
| `phones[].phone`           | string | Número de telefone              |
| `phones[].wa_id`           | string | WhatsApp ID                     |
| `phones[].type`            | string | `HOME` ou `WORK`                |
| `emails[].email`           | string | Email                           |
| `emails[].type`            | string | `HOME` ou `WORK`                |
| `addresses[].street`       | string | Rua                             |
| `addresses[].city`         | string | Cidade                          |
| `addresses[].state`        | string | Estado                          |
| `addresses[].zip`          | string | CEP                             |
| `addresses[].country`      | string | País                            |
| `addresses[].country_code` | string | Código do país                  |
| `addresses[].type`         | string | `HOME` ou `WORK`                |
| `org.company`              | string | Empresa                         |
| `org.department`           | string | Departamento                    |
| `org.title`                | string | Cargo                           |
| `birthday`                 | string | Data de nascimento (YYYY-MM-DD) |
| `urls[].url`               | string | URL                             |
| `urls[].type`              | string | `HOME` ou `WORK`                |

## Resposta

```json theme={null}
{
  "messaging_product": "whatsapp",
  "contacts": [{ "input": "5511999999999", "wa_id": "5511999999999" }],
  "messages": [{ "id": "wamid.HBgLNTUxMTk5OTk5OTk5..." }]
}
```