Docs/Integraciones/API REST

API REST

Integra Arizar IA con tus sistemas mediante nuestra API RESTful. Accede a conversaciones, contactos, mensajes y métricas programáticamente.

URL Base

https://api.arizar-ia.com/v1

Autenticación

Todas las peticiones deben incluir un header de autorización con tu API Key:

Authorization: Bearer tu_api_key_aqui

Genera tu API Key desde Configuración → API → Generar Nueva Key

Endpoints Principales

Método	Endpoint	Descripción
GET	/api/v1/conversations	Lista todas las conversaciones
GET	/api/v1/conversations/:id	Obtiene detalle de una conversación
POST	/api/v1/messages	Envía un mensaje a un contacto
GET	/api/v1/contacts	Lista todos los contactos
POST	/api/v1/contacts	Crea un nuevo contacto
GET	/api/v1/agents	Lista los agentes configurados
GET	/api/v1/analytics/summary	Obtiene métricas resumidas

Ejemplo de Uso

Obtener lista de conversaciones:

cURL

curl -X GET "https://api.arizar-ia.com/v1/conversations" \
  -H "Authorization: Bearer tu_api_key" \
  -H "Content-Type: application/json"

Respuesta:

JSON

{
  "success": true,
  "data": [
    {
      "id": "conv_abc123",
      "contact": {
        "name": "Juan Pérez",
        "phone": "+595981234567"
      },
      "status": "active",
      "lastMessage": "2024-01-15T10:30:00Z",
      "agent": "Soporte WhatsApp"
    }
  ],
  "pagination": {
    "page": 1,
    "total": 150
  }
}

Límites de Uso

100 peticiones/minuto por API Key
10,000 peticiones/día en plan estándar
Headers X-RateLimit-* en cada respuesta

SDKs Disponibles

Próximamente publicaremos SDKs oficiales para facilitar la integración:

JavaScript/Node.js (próximamente)Python (próximamente)PHP (próximamente)Java (próximamente)