Contacto

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": "[email protected]",
            "type": "Work"
          }
        ],
        "addresses": [
          {
            "street": "Calle Principal 123",
            "city": "Ciudad de México",
            "state": "CDMX",
            "zip": "01000",
            "country": "México",
            "country_code": "MX",
            "type": "Office"
          }
        ]
      }
    ]
  }'

{
  "success": true,
  "messageId": "msg_123456789"
}

{
  "message": "<string>",
  "statusMessage": "<string>",
  "status": 123,
  "error": {
    "code": "<string>",
    "key": "<string>",
    "description": "<string>",
    "developerMessages": {},
    "clientMessages": {}
  },
  "validationError": {}
}

{
  "message": "<string>",
  "statusMessage": "<string>",
  "status": 123,
  "error": {
    "code": "<string>",
    "key": "<string>",
    "description": "<string>",
    "developerMessages": {},
    "clientMessages": {}
  },
  "validationError": {}
}

{
  "message": "<string>",
  "statusMessage": "<string>",
  "status": 123,
  "error": {
    "code": "<string>",
    "key": "<string>",
    "description": "<string>",
    "developerMessages": {},
    "clientMessages": {}
  },
  "validationError": {}
}

POST

bots

{botId}

messages

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": "[email protected]",
            "type": "Work"
          }
        ],
        "addresses": [
          {
            "street": "Calle Principal 123",
            "city": "Ciudad de México",
            "state": "CDMX",
            "zip": "01000",
            "country": "México",
            "country_code": "MX",
            "type": "Office"
          }
        ]
      }
    ]
  }'

{
  "success": true,
  "messageId": "msg_123456789"
}

{
  "message": "<string>",
  "statusMessage": "<string>",
  "status": 123,
  "error": {
    "code": "<string>",
    "key": "<string>",
    "description": "<string>",
    "developerMessages": {},
    "clientMessages": {}
  },
  "validationError": {}
}

{
  "message": "<string>",
  "statusMessage": "<string>",
  "status": 123,
  "error": {
    "code": "<string>",
    "key": "<string>",
    "description": "<string>",
    "developerMessages": {},
    "clientMessages": {}
  },
  "validationError": {}
}

{
  "message": "<string>",
  "statusMessage": "<string>",
  "status": 123,
  "error": {
    "code": "<string>",
    "key": "<string>",
    "description": "<string>",
    "developerMessages": {},
    "clientMessages": {}
  },
  "validationError": {}
}

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": "[email protected]",
            "type": "Work"
          }
        ],
        "addresses": [
          {
            "street": "Calle Principal 123",
            "city": "Ciudad de México",
            "state": "CDMX",
            "zip": "01000",
            "country": "México",
            "country_code": "MX",
            "type": "Office"
          }
        ]
      }
    ]
  }'

Notas Importantes

Formato de Teléfono: Siempre usa formato E.164 para números de teléfono (ej: +PHONE_NUMBER) para asegurar compatibilidad entre diferentes regiones.

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

Autorizaciones

Authorization

string

header

requerido

Basic authentication using Base64 encoded clientId:clientSecret

Parámetros de ruta

botId

string

requerido

The unique identifier of the bot

Cuerpo

application/json

Message payload. The structure varies based on the message type.

type

enum<string>

requerido

Type of message to send

Opciones disponibles:

text

Ejemplo:

"text"

userId

string

requerido

Unique identifier of the user receiving the message. Accepts either a phone number in E.164 format without the leading '+' (e.g. '593999999999') or a BSUID (Business-Scoped User ID, e.g. 'US.13491208655302741918') for users who have enabled phone number privacy in WhatsApp.

Ejemplo:

"593999999999"

text

string

requerido

Text content of the message

Ejemplo:

"Hello, this is a text message"

botId

string

Unique identifier of the bot sending the message

Ejemplo:

"BOT_ID"

Respuesta

Message sent successfully

success

boolean

Ejemplo:

true

messageId

string

Ejemplo:

"msg_123456789"

Ubicación

Solicitud de Ubicación

⌘I

API reference

Envío de mensajes

Campañas

Conversaciones

Métricas

Usuarios

Recursos

Widget

Datum

Panel de Atención Externo

Gestión de Memoria

Notas Importantes

Casos de Uso

Autorizaciones

Parámetros de ruta

Cuerpo

Respuesta

​Notas Importantes

​Casos de Uso

Autorizaciones

Parámetros de ruta

Cuerpo

Respuesta

Notas Importantes

Casos de Uso