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

# Enviar Múltiplos Contatos

> Envia vários cartões de contato em uma única mensagem

## Descrição

Envia vários cartões de contato (vCards) em uma única mensagem para um contato ou grupo. O destinatário poderá salvar cada contato individualmente.

## Request

### Headers

```
Client-Token: SEU_CLIENT_TOKEN
Content-Type: application/json
```

### Body

```json theme={null}
{
  "phone": "5511999999999",
  "contacts": [
    {"name": "João Silva", "phone": "5511888888888"},
    {"name": "Maria Silva", "phone": "5511777777777"}
  ]
}
```

| Campo      | Tipo   | Obrigatório | Descrição                                                 |
| ---------- | ------ | ----------- | --------------------------------------------------------- |
| `phone`    | string | Sim         | Número do destinatário no formato DDI+DDD+número          |
| `contacts` | array  | Sim         | Lista de objetos de contato, cada um com `name` e `phone` |

### Estrutura de cada contato em `contacts`

| Campo   | Tipo   | Descrição                                |
| ------- | ------ | ---------------------------------------- |
| `name`  | string | Nome do contato                          |
| `phone` | string | Número de telefone no formato DDI+número |

## Response

### Sucesso (202)

```json theme={null}
{
  "messageId": "3EB0C767D02DCC481523",
  "id": "3EB0C767D02DCC481523"
}
```

## Exemplo cURL

```bash theme={null}
curl -X POST 'https://api.bliper.io/instances/{INSTANCE_ID}/token/{INSTANCE_TOKEN}/send-contacts' \
  -H 'Client-Token: SEU_CLIENT_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "phone": "5511999999999",
    "contacts": [
      {"name": "João Silva", "phone": "5511888888888"},
      {"name": "Maria Silva", "phone": "5511777777777"}
    ]
  }'
```

<Note>Para enviar apenas um contato, use o endpoint `/send-contact` que possui uma estrutura de body mais simples.</Note>
