Enviar Contactos

curl -X POST https://api.whaapy.com/messages/v1 \
  -H "Authorization: Bearer wha_TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+5215512345678",
    "type": "contacts",
    "contacts": [
      {
        "name": {
          "formatted_name": "Juan Pérez",
          "first_name": "Juan",
          "last_name": "Pérez"
        },
        "phones": [
          {
            "phone": "+5215598765432",
            "type": "WORK"
          }
        ]
      }
    ]
  }'

const response = await fetch('https://api.whaapy.com/messages/v1', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer wha_TU_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    to: '+5215512345678',
    type: 'contacts',
    contacts: [
      {
        name: {
          formatted_name: 'Juan Pérez',
          first_name: 'Juan',
          last_name: 'Pérez'
        },
        phones: [
          {
            phone: '+5215598765432',
            type: 'WORK'
          }
        ]
      }
    ]
  })
});

import requests

response = requests.post(
    'https://api.whaapy.com/messages/v1',
    headers={
        'Authorization': 'Bearer wha_TU_API_KEY',
        'Content-Type': 'application/json'
    },
    json={
        'to': '+5215512345678',
        'type': 'contacts',
        'contacts': [
            {
                'name': {
                    'formatted_name': 'Juan Pérez',
                    'first_name': 'Juan',
                    'last_name': 'Pérez'
                },
                'phones': [
                    {
                        'phone': '+5215598765432',
                        'type': 'WORK'
                    }
                ]
            }
        ]
    }
)

{
  "messaging_product": "whatsapp",
  "contacts": [
    { "input": "+5215512345678", "wa_id": "5215512345678" }
  ],
  "messages": [
    { "id": "550e8400-e29b-41d4-a716-446655440000", "wamid": "wamid.HBgLNTIxNTUx..." }
  ],
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "conversationId": "660e8400-e29b-41d4-a716-446655440001",
    "messageType": "contacts",
    "direction": "outbound",
    "status": "sent",
    "createdAt": "2026-01-22T10:30:00Z"
  }
}

POST

messages

curl -X POST https://api.whaapy.com/messages/v1 \
  -H "Authorization: Bearer wha_TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+5215512345678",
    "type": "contacts",
    "contacts": [
      {
        "name": {
          "formatted_name": "Juan Pérez",
          "first_name": "Juan",
          "last_name": "Pérez"
        },
        "phones": [
          {
            "phone": "+5215598765432",
            "type": "WORK"
          }
        ]
      }
    ]
  }'

const response = await fetch('https://api.whaapy.com/messages/v1', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer wha_TU_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    to: '+5215512345678',
    type: 'contacts',
    contacts: [
      {
        name: {
          formatted_name: 'Juan Pérez',
          first_name: 'Juan',
          last_name: 'Pérez'
        },
        phones: [
          {
            phone: '+5215598765432',
            type: 'WORK'
          }
        ]
      }
    ]
  })
});

import requests

response = requests.post(
    'https://api.whaapy.com/messages/v1',
    headers={
        'Authorization': 'Bearer wha_TU_API_KEY',
        'Content-Type': 'application/json'
    },
    json={
        'to': '+5215512345678',
        'type': 'contacts',
        'contacts': [
            {
                'name': {
                    'formatted_name': 'Juan Pérez',
                    'first_name': 'Juan',
                    'last_name': 'Pérez'
                },
                'phones': [
                    {
                        'phone': '+5215598765432',
                        'type': 'WORK'
                    }
                ]
            }
        ]
    }
)

{
  "messaging_product": "whatsapp",
  "contacts": [
    { "input": "+5215512345678", "wa_id": "5215512345678" }
  ],
  "messages": [
    { "id": "550e8400-e29b-41d4-a716-446655440000", "wamid": "wamid.HBgLNTIxNTUx..." }
  ],
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "conversationId": "660e8400-e29b-41d4-a716-446655440001",
    "messageType": "contacts",
    "direction": "outbound",
    "status": "sent",
    "createdAt": "2026-01-22T10:30:00Z"
  }
}

Comparte información de contacto como tarjetas vCard. El usuario podrá guardar el contacto directamente en su agenda.

Los contactos solo pueden enviarse dentro de la ventana de 24 horas. Fuera de la ventana, usa templates.

Ejemplo Básico

curl -X POST https://api.whaapy.com/messages/v1 \
  -H "Authorization: Bearer wha_TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+5215512345678",
    "type": "contacts",
    "contacts": [
      {
        "name": {
          "formatted_name": "Juan Pérez",
          "first_name": "Juan",
          "last_name": "Pérez"
        },
        "phones": [
          {
            "phone": "+5215598765432",
            "type": "WORK"
          }
        ]
      }
    ]
  }'

const response = await fetch('https://api.whaapy.com/messages/v1', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer wha_TU_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    to: '+5215512345678',
    type: 'contacts',
    contacts: [
      {
        name: {
          formatted_name: 'Juan Pérez',
          first_name: 'Juan',
          last_name: 'Pérez'
        },
        phones: [
          {
            phone: '+5215598765432',
            type: 'WORK'
          }
        ]
      }
    ]
  })
});

import requests

response = requests.post(
    'https://api.whaapy.com/messages/v1',
    headers={
        'Authorization': 'Bearer wha_TU_API_KEY',
        'Content-Type': 'application/json'
    },
    json={
        'to': '+5215512345678',
        'type': 'contacts',
        'contacts': [
            {
                'name': {
                    'formatted_name': 'Juan Pérez',
                    'first_name': 'Juan',
                    'last_name': 'Pérez'
                },
                'phones': [
                    {
                        'phone': '+5215598765432',
                        'type': 'WORK'
                    }
                ]
            }
        ]
    }
)

Contacto Completo

{
  "to": "+5215512345678",
  "type": "contacts",
  "contacts": [
    {
      "name": {
        "formatted_name": "Juan Pérez García",
        "first_name": "Juan",
        "last_name": "Pérez",
        "middle_name": "García",
        "prefix": "Lic.",
        "suffix": "Jr."
      },
      "phones": [
        {
          "phone": "+5215598765432",
          "type": "WORK",
          "wa_id": "5215598765432"
        },
        {
          "phone": "+5215512345678",
          "type": "CELL"
        }
      ],
      "emails": [
        {
          "email": "juan.perez@empresa.com",
          "type": "WORK"
        },
        {
          "email": "juanp@gmail.com",
          "type": "HOME"
        }
      ],
      "addresses": [
        {
          "street": "Av. Reforma 123",
          "city": "Ciudad de México",
          "state": "CDMX",
          "zip": "06600",
          "country": "México",
          "country_code": "MX",
          "type": "WORK"
        }
      ],
      "org": {
        "company": "Whaapy Inc.",
        "department": "Ventas",
        "title": "Director de Ventas"
      },
      "urls": [
        {
          "url": "https://whaapy.com",
          "type": "WORK"
        },
        {
          "url": "https://linkedin.com/in/juanperez",
          "type": "WORK"
        }
      ],
      "birthday": "1990-05-15"
    }
  ]
}

Múltiples Contactos

Puedes enviar varios contactos en un solo mensaje:

{
  "to": "+5215512345678",
  "type": "contacts",
  "contacts": [
    {
      "name": {
        "formatted_name": "Soporte Técnico",
        "first_name": "Soporte"
      },
      "phones": [
        { "phone": "+5215500001111", "type": "WORK" }
      ]
    },
    {
      "name": {
        "formatted_name": "Ventas",
        "first_name": "Ventas"
      },
      "phones": [
        { "phone": "+5215500002222", "type": "WORK" }
      ]
    },
    {
      "name": {
        "formatted_name": "Facturación",
        "first_name": "Facturación"
      },
      "phones": [
        { "phone": "+5215500003333", "type": "WORK" }
      ]
    }
  ]
}

Campos

Objeto Contact

array

required

Array de objetos de contacto. Puedes enviar múltiples contactos.

Objeto Name (requerido)

string

required

Nombre completo formateado. Este es el campo principal que ve el usuario.

string

Nombre de pila.

string

Apellido.

string

Segundo nombre o apellido materno.

string

Prefijo (Dr., Lic., Ing., etc.).

string

Sufijo (Jr., Sr., III, etc.).

Objeto Phone

string

required

Número de teléfono con código de país.

string

Tipo: CELL, MAIN, IPHONE, HOME, WORK.

string

ID de WhatsApp (solo si el número tiene WhatsApp).

Objeto Email

string

required

Dirección de correo electrónico.

string

Tipo: HOME, WORK.

Objeto Address

string

Calle y número.

string

Ciudad.

string

Estado o provincia.

string

Código postal.

string

País.

string

Código ISO del país (MX, US, ES, etc.).

string

Tipo: HOME, WORK.

Objeto Organization

string

Nombre de la empresa.

string

Departamento.

string

Cargo o título.

Objeto URL

string

required

URL del sitio web o perfil.

string

Tipo: HOME, WORK.

Otros Campos

string

Fecha de nacimiento en formato YYYY-MM-DD.

Respuesta Exitosa

{
  "messaging_product": "whatsapp",
  "contacts": [
    { "input": "+5215512345678", "wa_id": "5215512345678" }
  ],
  "messages": [
    { "id": "550e8400-e29b-41d4-a716-446655440000", "wamid": "wamid.HBgLNTIxNTUx..." }
  ],
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "conversationId": "660e8400-e29b-41d4-a716-446655440001",
    "messageType": "contacts",
    "direction": "outbound",
    "status": "sent",
    "createdAt": "2026-01-22T10:30:00Z"
  }
}

Casos de Uso

Compartir datos del asesor

{
  "contacts": [{
    "name": { "formatted_name": "María López - Tu Asesora" },
    "phones": [{ "phone": "+5215512345678", "type": "WORK", "wa_id": "5215512345678" }],
    "emails": [{ "email": "maria.lopez@empresa.com", "type": "WORK" }],
    "org": { "company": "Empresa SA", "title": "Asesora de Ventas" }
  }]
}

Directorio de departamentos

{
  "contacts": [
    {
      "name": { "formatted_name": "Soporte Técnico" },
      "phones": [{ "phone": "+5215500001111", "type": "WORK" }],
      "emails": [{ "email": "soporte@empresa.com", "type": "WORK" }]
    },
    {
      "name": { "formatted_name": "Ventas" },
      "phones": [{ "phone": "+5215500002222", "type": "WORK" }],
      "emails": [{ "email": "ventas@empresa.com", "type": "WORK" }]
    }
  ]
}

Tarjeta de negocio

{
  "contacts": [{
    "name": { 
      "formatted_name": "Restaurante La Parrilla",
      "first_name": "La Parrilla"
    },
    "phones": [
      { "phone": "+5215512345678", "type": "WORK" },
      { "phone": "+5215598765432", "type": "CELL" }
    ],
    "addresses": [{
      "street": "Av. Insurgentes 456",
      "city": "CDMX",
      "country": "México",
      "type": "WORK"
    }],
    "urls": [{ "url": "https://laparrilla.mx", "type": "WORK" }]
  }]
}

General

Mensajes

Media

Conversaciones

Contactos

Funnels

Templates

Agente IA

Equipo

Webhooks

Ejemplo Básico

Contacto Completo

Múltiples Contactos

Campos

Objeto Contact

Objeto Name (requerido)

Objeto Phone

Objeto Email

Objeto Address

Objeto Organization

Objeto URL

Otros Campos

Respuesta Exitosa

Casos de Uso

Próximos Pasos

Enviar Reacciones

Reintentar Mensaje

​Ejemplo Básico

​Contacto Completo

​Múltiples Contactos

​Campos

​Objeto Contact

​Objeto Name (requerido)

​Objeto Phone

​Objeto Email

​Objeto Address

​Objeto Organization

​Objeto URL

​Otros Campos

​Respuesta Exitosa

​Casos de Uso

​Próximos Pasos

Enviar Reacciones

Reintentar Mensaje

Ejemplo Básico

Contacto Completo

Múltiples Contactos

Campos

Objeto Contact

Objeto Name (requerido)

Objeto Phone

Objeto Email

Objeto Address

Objeto Organization

Objeto URL

Otros Campos

Respuesta Exitosa

Casos de Uso

Próximos Pasos