Endpoint POST https://api.jelou.ai/v1/bots/{botId}/messages Parámetros de Ruta Identificador único del bot que envía el mensaje.
Cuerpo de la Solicitud Array de objetos de contacto. Cada contacto puede incluir nombre, números de teléfono, correos electrónicos y direcciones.
Identificador único del usuario que recibirá el mensaje.
Show Propiedades del Contacto
Información del nombre del contacto. Show Propiedades del Nombre
contacts[].name.formatted_name
Nombre completo formateado del contacto.
contacts[].name.first_name
Nombre del contacto.
contacts[].name.last_name
Apellido del contacto.
contacts[].name.middle_name
Segundo nombre del contacto.
Array de números de teléfono del contacto. Show Propiedades del Teléfono
contacts[].phones[].phone
Número de teléfono en formato E.164 (ej: +1234567890).
Tipo de número de teléfono (ej: “Mobile”, “Work”, “Home”).
contacts[].phones[].wa_id
ID de WhatsApp asociado con el número de teléfono.
Array de direcciones de correo electrónico del contacto. Show Propiedades del Email
contacts[].emails[].email
Dirección de correo electrónico del contacto.
Tipo de correo (ej: “Work”, “Personal”).
Array de direcciones del contacto. Show Propiedades de la Dirección
contacts[].addresses[].street
Dirección de la calle.
contacts[].addresses[].city
Nombre de la ciudad.
contacts[].addresses[].state
Estado o provincia.
contacts[].addresses[].zip
Código postal o ZIP.
contacts[].addresses[].country
Nombre del país.
contacts[].addresses[].country_code
Código ISO del país (ej: “US”, “MX”).
contacts[].addresses[].type
Tipo de dirección (ej: “Office”, “Home”).
Ejemplos de Solicitud 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": "+1234567890", "type": "Mobile", "wa_id": "1234567890" } ], "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" } ] } ] }' Respuesta Indica si el mensaje fue enviado exitosamente.
Identificador único del mensaje enviado.
Ejemplo de Respuesta { "success" : true , "messageId" : "msg_123456789" } Notas Importantes Formato de Teléfono: Siempre usa formato E.164 para números de teléfono (ej: +1234567890) 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
