Skip to main content

Endpoint

POST https://api.jelou.ai/v1/bots/{botId}/messages

Parámetros de Ruta

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

Cuerpo de la Solicitud

type
string
required
Debe ser "location".
coordinates
object
required
Objeto que contiene la latitud y longitud de la ubicación.
userId
string
required
Identificador único del usuario que recibirá el mensaje.

Ejemplos de Solicitud

cURL
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": "location",
    "coordinates": {
      "lat": 40.7128,
      "long": -74.0060
    },
    "userId": "USER_ID"
  }'

Respuesta

success
boolean
Indica si el mensaje fue enviado exitosamente.
messageId
string
Identificador único del mensaje enviado.

Ejemplo de Respuesta

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

Notas Importantes

Precisión de Coordenadas: Asegúrate de que las coordenadas sean precisas y estén en formato decimal. Usa valores negativos para latitud sur y longitud oeste.

Casos de Uso

  • Compartir ubicaciones de tiendas con clientes
  • Proporcionar direcciones a eventos o lugares
  • Compartir ubicaciones de recogida o entrega
  • Mostrar puntos de interés cercanos