# Enviar contato

> Envie de 1 a 10 cartões de contato pelo WhatsApp com POST /v1/messages e type contacts, com nome, telefones e e-mails.

`type: "contacts"` envia cartões de contato que o destinatário salva com um toque. Só no WhatsApp. Os campos comuns a todos os tipos (`to`, `reply_to`, `typing`, `delay_ms`, janela de 24 h) estão em [Campos comuns](/send/text/#campos-comuns).

## Campos

`contacts` é uma lista de 1 a 10 cartões.

| Campo | Regra |
| --- | --- |
| `contacts[].name.formatted_name` | Obrigatório, de 1 a 256 caracteres |
| `contacts[].name.first_name` | Opcional, até 128 caracteres |
| `contacts[].name.last_name` | Opcional, até 128 caracteres |
| `contacts[].phones` | Opcional, até 10 itens |
| `contacts[].phones[].phone` | De 1 a 64 caracteres |
| `contacts[].phones[].type` | Opcional, até 32 caracteres (ex.: `CELL`, `WORK`) |
| `contacts[].phones[].wa_id` | Opcional, até 64 caracteres: o número no WhatsApp, para o botão de conversa |
| `contacts[].emails` | Opcional, até 10 itens |
| `contacts[].emails[].email` | De 1 a 128 caracteres |
| `contacts[].emails[].type` | Opcional, até 32 caracteres |

## Enviar um contato

**cURL**

```bash
curl https://api.messajo.com/v1/messages \
  -H "Authorization: Bearer $MESSAJO_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "connection_id": "conn_...",
    "to": "5511999999999",
    "type": "contacts",
    "contacts": [
      {
        "name": { "formatted_name": "Ana Souza", "first_name": "Ana", "last_name": "Souza" },
        "phones": [{ "phone": "+55 11 98888-7777", "type": "CELL", "wa_id": "5511988887777" }],
        "emails": [{ "email": "ana@exemplo.com", "type": "WORK" }]
      }
    ]
  }'
```

**TypeScript**

```ts
import { Messajo } from "@messajo/sdk";

const messajo = new Messajo({ apiKey: process.env.MESSAJO_API_KEY! });

const sent = await messajo.messages.send({
  connection_id: "conn_...",
  to: "5511999999999",
  type: "contacts",
  contacts: [
    {
      name: { formatted_name: "Ana Souza", first_name: "Ana", last_name: "Souza" },
      phones: [{ phone: "+55 11 98888-7777", type: "CELL", wa_id: "5511988887777" }],
      emails: [{ email: "ana@exemplo.com", type: "WORK" }],
    },
  ],
});
```

**n8n**

n8n HTTP Request: POST https://api.messajo.com/v1/messages

```json
{
  "connection_id": "conn_...",
  "to": "5511999999999",
  "type": "contacts",
  "contacts": [
    {
      "name": { "formatted_name": "Ana Souza", "first_name": "Ana", "last_name": "Souza" },
      "phones": [{ "phone": "+55 11 98888-7777", "type": "CELL", "wa_id": "5511988887777" }],
      "emails": [{ "email": "ana@exemplo.com", "type": "WORK" }]
    }
  ]
}
```

A resposta é a mesma do envio de texto (`201`, `status: "queued"`); veja [Resposta](/send/text/#resposta).

## Erros

- `422` [`outside_service_window`](/errors#outside_service_window): contato é mensagem livre, então só sai dentro de 24 horas da última mensagem do destinatário. Fora da janela, use um [template](/guides/templates/).
- `422` [`type_not_supported_by_channel`](/errors#type_not_supported_by_channel): conexão do Instagram ou do Messenger. Contato é só do WhatsApp.
- `400` [`validation_failed`](/errors#validation_failed): lista vazia ou com mais de 10 cartões, `formatted_name` ausente, limite de tamanho excedido ou campo desconhecido.
