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

# Contacto

> Envía una tarjeta de contacto (vCard)

Disponible solo en WhatsApp

```bash cURL theme={null}
curl --request POST \
  --url https://api.jelou.ai/v1/bots/BOT_ID/messages \
  --header 'Authorization: Basic <Base64Encoded clientId:clientSecret>' \
  --header 'Content-Type: application/json' \
  --data '{
    "type": "contacts",
    "userId": "USER_ID",
    "contacts": [
      {
        "name": {
          "formatted_name": "Juan Pérez",
          "first_name": "Juan",
          "last_name": "Pérez"
        },
        "phones": [
          {
            "phone": "+PHONE_NUMBER",
            "type": "Mobile",
            "wa_id": "PHONE_NUMBER"
          }
        ],
        "emails": [
          {
            "email": "juan.perez@example.com",
            "type": "Work"
          }
        ],
        "addresses": [
          {
            "street": "Calle Principal 123",
            "city": "Ciudad de México",
            "state": "CDMX",
            "zip": "01000",
            "country": "México",
            "country_code": "MX",
            "type": "Office"
          }
        ]
      }
    ]
  }'
```

```json 200 theme={null}
{
  "success": true,
  "messageId": "msg_123456789"
}
```

## Parámetros de ruta

**botId** `string` *required*

Identificador único del bot que envía el mensaje.

## Parámetros del cuerpo

**type** `string` *required*

Tipo de mensaje. Debe ser `"contacts"`.

**userId** `string` *required*

Destinatario del mensaje. Acepta un número de teléfono en formato E.164 sin el signo `+` (ej: `593999999999`) o un BSUID (ej: `US.13491208655302741918`) para usuarios con protección de número activada en WhatsApp. Consulta [Identificación del destinatario](https://docs.jelou.ai/api/envia-mensajes/Envio-de-mensajes.md#identificación-del-destinatario).

**contacts** `object[]` *required*

Lista de tarjetas de contacto.

**propiedades**

**name** `object`

Nombre del contacto.

**propiedades**

**formatted\_name** `string`

Nombre completo tal como se muestra.

**first\_name** `string`

Nombre.

**last\_name** `string`

Apellido.

**middle\_name** `string`

Segundo nombre.

**phones** `object[]`

Teléfonos del contacto.

**propiedades**

**phone** `string`

Número en formato E.164.

**type** `string`

Tipo de teléfono (ej: `Mobile`).

**wa\_id** `string`

ID de WhatsApp del contacto.

**emails** `object[]`

Correos del contacto.

**propiedades**

**email** `string`

Dirección de correo.

**type** `string`

Tipo de correo (ej: `Work`).

**addresses** `object[]`

Direcciones del contacto.

**propiedades**

**street** `string`

Calle.

**city** `string`

Ciudad.

**state** `string`

Estado o provincia.

**zip** `string`

Código postal.

**country** `string`

País.

**country\_code** `string`

Código ISO del país (ej: `MX`).

**type** `string`

Tipo de dirección (ej: `Office`).

## Respuesta

**success** `boolean`

`true` si el mensaje se envió correctamente.

**messageId** `string`

Identificador del mensaje enviado.

## Notas Importantes

> [!NOTE]
>
> **Formato de Teléfono:** Siempre usa formato E.164 para números de teléfono (ej: +PHONE\_NUMBER) para asegurar compatibilidad entre diferentes regiones.

> [!NOTE]
>
> **Completitud del Contacto:** Aunque todos los campos son opcionales, proporcionar información completa del contacto (nombre, teléfono, email) mejora la experiencia del usuario y hace los contactos más útiles.

## Casos de Uso

* Compartir información de contacto de soporte
* Referir usuarios a miembros específicos del equipo
* Proporcionar información de tarjetas de presentación
* Compartir contactos de emergencia


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.