Multiplica tus Ventas con IKOMCRM

Introducción

La API de IKOMCRM te permite acceder programáticamente a todas las funcionalidades del CRM. Construye integraciones personalizadas, automatiza procesos y crea aplicaciones que se conecten con tu CRM.

URL Base:

https://api.ikomcrm.com/v1/

Formato de Respuesta:

Todas las respuestas están en formato JSON.

Autenticación

Utilizamos OAuth 2.0 y API Keys para autenticar las solicitudes. Obtén tu API Key desde tu panel de configuración.

Usando API Key:

curl -X GET "https://api.ikomcrm.com/v1/contacts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
                        

Importante: Nunca expongas tu API Key en código del lado del cliente. Úsala solo en el backend de tu aplicación.

Endpoints Principales

GET /contacts

Obtiene la lista de todos los contactos

// Ejemplo de respuesta
{
  "data": [
    {
      "id": "123",
      "name": "Juan Pérez",
      "email": "juan@example.com",
      "phone": "+1234567890",
      "company": "Tech Corp",
      "created_at": "2025-01-15T10:30:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 50,
    "total": 250
  }
}
                            

POST /contacts

Crea un nuevo contacto

// Ejemplo de request
{
  "name": "María García",
  "email": "maria@example.com",
  "phone": "+1234567890",
  "company": "Startup Inc",
  "tags": ["lead", "high-priority"]
}
                            

GET /deals

Obtiene todas las oportunidades

POST /deals

Crea una nueva oportunidad

PUT /deals/:id

Actualiza una oportunidad existente

DELETE /contacts/:id

Elimina un contacto

Ver Documentación Completa

Webhooks

Recibe notificaciones en tiempo real cuando ocurran eventos en tu CRM.

Eventos Disponibles:

contact.created - Cuando se crea un contacto
contact.updated - Cuando se actualiza un contacto
deal.created - Cuando se crea una oportunidad
deal.stage_changed - Cuando cambia la etapa de una oportunidad
deal.won - Cuando se gana una oportunidad
deal.lost - Cuando se pierde una oportunidad

Ejemplo de Payload:

{
  "event": "deal.stage_changed",
  "timestamp": "2025-01-15T14:30:00Z",
  "data": {
    "deal_id": "789",
    "old_stage": "Proposal",
    "new_stage": "Negotiation",
    "value": 15000
  }
}
                        

SDKs Oficiales

Utiliza nuestras bibliotecas oficiales para integrar IKOMCRM más fácilmente.

JavaScript/Node.js

npm install ikomcrm-sdk

Python

pip install ikomcrm

PHP

composer require ikomcrm/php-sdk

Java

implementation 'com.ikomcrm:sdk:1.0.0'

Rate Limits

Para garantizar la estabilidad del servicio, aplicamos los siguientes límites:

Plan	Requests por Minuto	Requests por Hora
Starter	60	1,000
Professional	120	5,000
Enterprise	300	20,000

Si excedes el límite, recibirás un error 429 Too Many Requests

Ejemplos de Código

JavaScript (Node.js):

const IKOMCRM = require('ikomcrm-sdk');

const client = new IKOMCRM({
  apiKey: 'YOUR_API_KEY'
});

// Crear un contacto
const contact = await client.contacts.create({
  name: 'Juan Pérez',
  email: 'juan@example.com',
  phone: '+1234567890'
});

console.log('Contacto creado:', contact);
                        

Python:

from ikomcrm import Client

client = Client(api_key='YOUR_API_KEY')

# Crear un contacto
contact = client.contacts.create(
    name='Juan Pérez',
    email='juan@example.com',
    phone='+1234567890'
)

print(f'Contacto creado: {contact.id}')
                        

Contenido

API para Desarrolladores