API BuilderBot para WhatsApp

Esta API permite la creación, gestión y control de bots para WhatsApp. Para su uso es necesario si o si la autenticacion y registro de usuario. Se debe enviar en todas las peticiones el TOKEN de autenticacion!. A continuación, se describen los endpoints disponibles.

Endpoints

1. /bots

Gestiona la lista de bots.

POST /bots
{
    "name": "Nombre del bot",
    "phone": "Número de teléfono asociado",
    "description": "Descripción del bot"
}

2. /bots/:id

Gestiona un bot específico.

POST /bots/:id
{
    "nombre": "Nombre del bot",
    "numbersRespondAi": "Número asociado",
    "owner": "Propietario del bot",
    "port": "Puerto asignado",
    "status": "Estado del bot",
    "chatFlowId": "Identificador del flujo de chat"
}

3. /bots/:id/qr

Genera un código QR para escanear y conectar el bot con WhatsApp.

GET /bots/:id/qr
Response HTML:
{
   HTML con la imagen del QR
}

4. /bots/:id/status

Consulta el estado actual del bot.

GET /bots/:id/status
Response:
{
    "status": "activo"
}

5. /bots/:id/logout

Desconecta el bot de WhatsApp.

POST /bots/:id/logout
Response:
{
    "message": "Bot desconectado exitosamente."
}

6. /bots/:id/message

Envía mensajes desde el bot a través de WhatsApp.

POST /bots/:id/message
{
    "nroTelefono": "Número del destinatario",
    "mensaje": "Texto del mensaje",
    "urlMedia": "URL del archivo multimedia (opcional)",
    "flow": "Identificador del flujo de chat (opcional)",
    "token": "Token de autenticación"
}

7. /user/regenerate_token

Regenera un token de usuario.

POST /user/regenerate_token
{
    "username": "Nombre de usuario",
    "password": "Contraseña"
}
Response:
{
    "token": "Nuevo token generado"
}

8. /user/login

Inicia sesión y genera un token.

POST /user/login
{
    "username": "Nombre de usuario",
    "password": "Contraseña"
}
Response:
{
    "token": "Token de autenticación"
}

9. /user/register

Registra un nuevo usuario.

POST /user/register
{
    "username": "Nombre de usuario",
    "password": "Contraseña"
}
Response:
{
    "token": "Token de autenticación"
}

Ejemplo de Bot