# Enviar contacto

> Envía de 1 a 10 tarjetas de contacto por WhatsApp con POST /v1/messages y type contacts, con nombre, teléfonos y correos.

`type: "contacts"` envía tarjetas de contacto que el destinatario guarda con un toque. Solo en WhatsApp. Los campos comunes a todos los tipos (`to`, `reply_to`, `typing`, `delay_ms`, ventana de 24 h) están en [Campos comunes](/es/send/text/#campos-comunes).

## Campos

`contacts` es una lista de 1 a 10 tarjetas.

| Campo | Regla |
| --- | --- |
| `contacts[].name.formatted_name` | Obligatorio, de 1 a 256 caracteres |
| `contacts[].name.first_name` | Opcional, hasta 128 caracteres |
| `contacts[].name.last_name` | Opcional, hasta 128 caracteres |
| `contacts[].phones` | Opcional, hasta 10 elementos |
| `contacts[].phones[].phone` | De 1 a 64 caracteres |
| `contacts[].phones[].type` | Opcional, hasta 32 caracteres (p. ej. `CELL`, `WORK`) |
| `contacts[].phones[].wa_id` | Opcional, hasta 64 caracteres: el número en WhatsApp, para el botón de chat |
| `contacts[].emails` | Opcional, hasta 10 elementos |
| `contacts[].emails[].email` | De 1 a 128 caracteres |
| `contacts[].emails[].type` | Opcional, hasta 32 caracteres |

## Enviar un contacto

**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@ejemplo.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@ejemplo.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@ejemplo.com", "type": "WORK" }]
    }
  ]
}
```

La respuesta es la misma que la del envío de texto (`201`, `status: "queued"`); consulta [Respuesta](/es/send/text/#respuesta).

## Errores

- `422` [`outside_service_window`](/es/errors#outside_service_window): un contacto es un mensaje libre, así que solo sale dentro de las 24 horas desde el último mensaje del destinatario. Fuera de la ventana, usa una [plantilla](/es/guides/templates/).
- `422` [`type_not_supported_by_channel`](/es/errors#type_not_supported_by_channel): conexión de Instagram o Messenger. Los contactos son solo de WhatsApp.
- `400` [`validation_failed`](/es/errors#validation_failed): lista vacía o con más de 10 tarjetas, falta `formatted_name`, se superó un límite de tamaño o hay un campo desconocido.
