Chat.IA26 API

https://chatia26.bitnodo.net/api/v1

Authorization: Bearer sk_live_your_secret_key_here
Content-Type: application/json

X-API-Key: sk_live_your_secret_key_here
Content-Type: application/json

curl -X POST https://chatia26.bitnodo.net/api/v1/chats \
  -H "Authorization: Bearer sk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "client_name": "Juan Pérez",
    "client_number": "+56912345678",
    "platform": "web",
    "metadata": {
      "user_id": 123,
      "source": "sitio-web"
    }
  }'

{
  "success": true,
  "chat": {
    "id": "chat_abc123xyz",
    "client_name": "Juan Pérez",
    "client_number": "+56912345678",
    "platform": "web",
    "status": "active",
    "orchestrator_id": "orch_def456",
    "created_at": "2026-03-09T10:30:00Z",
    "updated_at": "2026-03-09T10:30:00Z",
    "metadata": {
      "user_id": 123,
      "source": "sitio-web"
    }
  }
}

https://miservidor.com/webhooks/chat-message

{
  "event": "chat.message_received",
  "chat_id": "chat_abc123xyz",
  "message": {
    "id": "msg_xyz789",
    "sender": "assistant",
    "text": "Hola, ¿en qué puedo ayudarte?",
    "type": "text",
    "created_at": "2026-03-09T10:30:15Z"
  },
  "timestamp": "2026-03-09T10:30:15Z"
}

<script
  src="https://chatia26.bitnodo.net/widget/chat.js"
    data-widget-token="TU_WIDGET_TOKEN"
  data-primary-color="#2563eb"
  async
></script>

{
  "name": "Asistente Ventas",
  "description": "Atiende consultas de precios y disponibilidad",
  "version": "1.0",
  "welcome_message": "Hola, soy el asistente de ventas. ¿En qué puedo ayudarte?",
  "nodes": [
    {
      "id": "node_1",
      "type": "message",
      "text": "Nuestro producto cuesta $99 por mes",
      "next_node": "node_2"
    },
    {
      "id": "node_2",
      "type": "question",
      "question": "¿Te interesa conocer más?",
      "options": [
        {
          "text": "Sí",
          "next_node": "node_3"
        },
        {
          "text": "No thanks",
          "next_node": "end_escalate"
        }
      ]
    },
    {
      "id": "node_3",
      "type": "action",
      "action": "transfer_to_agent",
      "agent_type": "sales"
    },
    {
      "id": "end_escalate",
      "type": "end"
    }
  ]
}

curl -X POST https://chatia26.bitnodo.net/api/v1/orchestrators \
  -H "Authorization: Bearer sk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d @docs/examples/orquestador-sa-publicidad-estricto.json

<iframe
  src="https://chatia26.bitnodo.net/visual-orchestrator/?token=TU_TOKEN_BEARER"
  style="width:100%;height:650px;border:none;border-radius:12px;overflow:hidden;background:#020617;"
></iframe>

<!-- CSS del Visual Orchestrator -->
<link rel="stylesheet" href="https://chatia26.bitnodo.net/visual-orchestrator/assets/css/styles.css">

<!-- Scripts del Visual Orchestrator (sin pantalla de login) -->
<script src="https://chatia26.bitnodo.net/visual-orchestrator/assets/js/canvas.js"></script>
<script src="https://chatia26.bitnodo.net/visual-orchestrator/assets/js/elements.js"></script>
<script src="https://chatia26.bitnodo.net/visual-orchestrator/assets/js/properties.js"></script>
<script src="https://chatia26.bitnodo.net/visual-orchestrator/assets/js/export.js"></script>
<script src="https://chatia26.bitnodo.net/visual-orchestrator/assets/js/chat-tester.js"></script>
<script src="https://chatia26.bitnodo.net/visual-orchestrator/assets/js/ui.js"></script>
<script src="https://chatia26.bitnodo.net/visual-orchestrator/assets/js/app.js"></script>
<script src="https://chatia26.bitnodo.net/visual-orchestrator/assets/js/builder.js"></script>

// Crear instancia del Visual Builder
const builder = new VisualOrchestratorBuilder({
    container: '#orchestrator-editor',  // ID del div donde se renderiza
    apiKey: 'sk_live_YOUR_KEY',         // Opcional (para tu propia lógica)
    apiUrl: 'https://chatia26.bitnodo.net/api/v1',
  
    // Evento cuando el usuario guarda (Ctrl+S o botón "Guardar")
    onSave: (orchestratorConfig) => {
        console.log('Orquestrador guardado (formato API):', orchestratorConfig);
        // Aquí envías el JSON a tu API o almacenamiento
        saveToDatabase(orchestratorConfig);
    },

    // Cuando cargas un orquestador existente
    onLoad: (config) => {
        console.log('Orquestrador cargado en el editor:', config);
    }
});

// Para cargar un orquestador existente desde tu API
builder.load({
    id: 'orch_abc123',
    configuration: existingOrchestratorJSON
});

<!DOCTYPE html>
<html>
<head>
  <title>Mi Panel de Control</title>
  <link rel="stylesheet" href="https://chatia26.bitnodo.net/visual-orchestrator/builder.css">
</head>
<body>
  <div class="dashboard">
    <h1>Crear Asistente</h1>
    <div id="orchestrator-editor" style="height: 600px; border: 1px solid #ccc;"></div>
  </div>
  
  <script src="https://chatia26.bitnodo.net/visual-orchestrator/builder.min.js"></script>
  <script>
    // Inicializar el Visual Builder
    const builder = new VisualOrchestratorBuilder({
      container: '#orchestrator-editor',
      apiKey: localStorage.getItem('api_key'), // Tu clave de API
      apiUrl: 'https://chatia26.bitnodo.net/api/v1',
      
      // Cuando el usuario presiona "Guardar"
      onSave: async (config) => {
        try {
          // Enviar el JSON a tu servidor
          const response = await fetch('/mi-api/orchestrators', {
            method: 'POST',
            headers: {
              'Content-Type': 'application/json',
              'Authorization': 'Bearer ' + localStorage.getItem('auth_token')
            },
            body: JSON.stringify({
              name: config.name,
              description: config.description,
              // El JSON completo del orquestrador
              configuration: config
            })
          });
          
          if (response.ok) {
            const result = await response.json();
            alert('✓ Orquestrador guardado: ' + result.id);
            
            // Ahora puedes usar este orquestrador en Chat.IA26
            console.log('Guardado en Chat.IA26 como:', result.id);
          } else {
            alert('Error al guardar');
          }
        } catch (err) {
          console.error('Error:', err);
        }
      },
      
      // Cuando se carga un orquestrador existente
      onLoad: (config) => {
        console.log('Orquestrador cargado:', config);
      }
    });
  </script>
</body>
</html>

1. Usuario abre tu dashboard
   ↓
2. Ve el Visual Builder (lo incrustaste con VisualOrchestratorBuilder)
   ↓
3. Diseña flujo visualmente (arrastra nodos, conecta, configura)
   ↓
4. Presiona "Guardar"
   ↓
5. Callback onSave() se ejecuta → Tu app obtiene el JSON
   ↓
6. Tu app envía JSON a Chat.IA26:
   POST https://chatia26.bitnodo.net/api/v1/orchestrators
   Body: { name: "...", configuration: {...} }
   ↓
7. Chat.IA26 devuelve ID: orch_abc123
   ↓
8. Cuando crees un chat, usa ese ID:
   POST /chats
   Body: { orchestrator_id: "orch_abc123", ... }
   ↓
9. El asistente responde según el flujo que definió el usuario

// Cargar un orquestrador existente
builder.load(orchestratorJSON);

// Obtener el JSON actual del editor
const json = builder.getConfiguration();

// Validar el flujo (devuelve true/false)
const isValid = builder.validate();

// Limpiar el editor
builder.clear();

// Exportar como JSON (descarga archivo)
builder.export('json');

// Importar desde JSON
builder.import(jsonString);

// Obtener errores de validación
const errors = builder.getValidationErrors();

// 1) Inicializar el builder en modo whatsapp_metadata
const builder = new VisualOrchestratorBuilder({
    container: '#orchestrator-editor',
    mode: 'whatsapp_metadata',
    onSave: (metadataJson) => {
        // metadataJson tiene el mismo formato que orquestador-sa-publicidad-estricto.json
        // Lo puedes guardar tal cual en tu base de datos o en el campo
        // "JSON de metadata por defecto" de tu integración de WhatsApp.
        saveWhatsappMetadata(JSON.stringify(metadataJson));
    }
});

// 2) Cargar desde tu textarea/campo de configuración
const rawMetadata = getWhatsappMetadataFromDB(); // string JSON
if (rawMetadata) {
    try {
        const parsed = JSON.parse(rawMetadata);
        builder.load(parsed); // El builder dibuja el flujo directamente
    } catch (e) {
        console.error('JSON de metadata inválido', e);
    }
}

// 3) Cuando quieras leer el valor para guardarlo manualmente:
const currentMetadata = builder.getConfiguration();
// currentMetadata es el mismo JSON de metadata que puedes volver a persistir

const builder = new VisualOrchestratorBuilder({
  container: '#editor',
  apiKey: 'sk_live_YOUR_KEY',
  
  onSave: async (config) => {
    // config es el JSON completo del orquestrador
    
    // 1. Guardar en tu BD
    const saveResponse = await fetch('/api/my-orchestrators', {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({
        name: config.name,
        description: config.description,
        configuration_json: JSON.stringify(config), // Guardar como texto
        created_by: currentUser.id
      })
    });
    
    const saved = await saveResponse.json();
    const localId = saved.id; // ID en tu BD
    
    // 2. Enviar a Chat.IA26
    const chatResponse = await fetch('https://chatia26.bitnodo.net/api/v1/orchestrators', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer sk_live_YOUR_KEY'
      },
      body: JSON.stringify({
        name: config.name,
        description: config.description,
        configuration: config
      })
    });
    
    const chatOrc = await chatResponse.json();
    const chatOrcId = chatOrc.orchestrator.id; // ID en Chat.IA26
    
    // 3. Guardar relación (tu ID local ↔ Chat.IA26 ID)
    await fetch(`/api/my-orchestrators/${localId}`, {
      method: 'PATCH',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({
        chatia26_id: chatOrcId
      })
    });
    
    alert('✓ Orquestrador guardado localmente y en Chat.IA26');
  }
});

https://miservidor.com/webhooks/chat-ia26

{
  "id": "webhook_evt_12345",
  "timestamp": "2026-03-09T11:30:45Z",
  "event": "chat.message_received",
  "chat_id": "chat_abc123xyz",
  "data": {
    "message": {
      "id": "msg_xyz789",
      "sender": "client",
      "text": "¿Cuál es el precio?",
      "type": "text",
      "created_at": "2026-03-09T11:30:45Z"
    },
    "chat": {
      "id": "chat_abc123xyz",
      "client_name": "Juan Pérez",
      "client_number": "+56912345678"
    }
  }
}

app.post('/webhooks/chat-ia26', (req, res) => {
  const { event, chat_id, data } = req.body;
  
  switch(event) {
    case 'chat.created':
      console.log('Nuevo chat:', chat_id, data.chat.client_name);
      // Guardar en tu BD, enviar email, etc.
      break;
      
    case 'chat.message_received':
      console.log('Mensaje del cliente:', data.message.text);
      // Procesar mensaje, guardar en BD, etc.
      break;
      
    case 'chat.transferred':
      console.log('Chat transferido a:', data.assigned_to);
      // Notificar al agente
      break;
  }
  
  // Responder con 200 OK para confirmar recepción
  res.status(200).json({ success: true });
});

async function createChat(clientDetails) {
  try {
    const response = await fetch(
      'https://chatia26.bitnodo.net/api/v1/chats',
      {
        method: 'POST',
        headers: {
          'Authorization': 'Bearer ' + apiKey,
          'Content-Type': 'application/json'
        },
        body: JSON.stringify(clientDetails)
      }
    );
    
    const result = await response.json();
    
    if (!response.ok) {
      // Manejar error
      if (response.status === 401) {
        console.error('API Key inválida');
      } else if (response.status === 400) {
        console.error('Datos inválidos:', result.error);
      } else if (response.status === 500) {
        console.error('Error del servidor. Request ID:', result.request_id);
      }
      return null;
    }
    
    return result.chat;
    
  } catch (err) {
    console.error('Error de red:', err);
    return null;
  }
}