watsiwatsi docs

Envíe su primer mensaje en 5 minutos

Esta guía lo lleva paso a paso por la creación de una clave de API, el listado de sus conversaciones y el envío de un mensaje de WhatsApp a través de la API de watsi.

Requisitos previos
  • Una cuenta de watsi con un número de WhatsApp Business conectado
  • Una conversación existente (envíe un mensaje a su número de WhatsApp Business para crear una)
Paso 1

Cree una clave de API

Abra Configuración → Claves de API en el panel de watsi y haga clic en Generar nueva clave. Copie la clave de inmediato — solo se muestra una vez.

Paso 2

Liste sus conversaciones

Verifique que su clave funciona obteniendo las conversaciones. Reemplace YOUR_API_KEY por la clave del paso 1.

curl https://api.watsi.ai/api/v1/conversations \
  -H "Authorization: Bearer YOUR_API_KEY"

Respuesta

{
  "chats": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "customer": {
        "name": "Maria Garcia",
        "phone": "+5491155551234"
      },
      "last_message_at": "2025-03-15T10:30:00.000Z",
      "status": "open"
    }
  ],
  "hasMore": false
}
Paso 3

Envíe un mensaje

Elija un ID de conversación de la respuesta anterior y envíe un mensaje de texto. Los mensajes solo pueden enviarse dentro de la ventana de mensajería de 24 horas de WhatsApp (desde el último mensaje entrante del cliente).

curl -X POST https://api.watsi.ai/api/v1/messages \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "conversation_id": "550e8400-e29b-41d4-a716-446655440000",
    "body": "Hello from the watsi API!"
  }'

Respuesta

{
  "message": {
    "id": "msg_01HXYZ987654321",
    "conversation_id": "550e8400-e29b-41d4-a716-446655440000",
    "body": "Hello from the watsi API!",
    "direction": "outbound",
    "status": "sent",
    "created_at": "2025-03-15T10:35:00.000Z"
  }
}
Paso 4

Consulte el estado del mensaje

El campo status del mensaje se actualizará a medida que WhatsApp procesa la entrega. También puede recibir actualizaciones de estado en tiempo real mediante webhooks.

Próximos pasos