Contactos del CRM

Lleva al CRM los clientes que llegan por tu formulario web, landing page u otro sistema. Si el número ya existe, se completan los datos vacíos y se suman las etiquetas (nunca se borra nada). Solo necesita la API key.

Contactos del CRM

POST https://api.kontacto.pro/crm/contacts

Parámetros · cuerpo JSON si es POST

Parámetro	Tipo	Requerido	Descripción
api_key	string	Sí	Tu API key.
number	string	Sí	Número con código de país (51999888777).
name	string	No	Nombre del contacto.
email	string	No	Correo.
company	string	No	Empresa (se crea si no existe).
position	string	No	Cargo.
city	string	No	Ciudad.
source	string	No	Origen: web, api, referido, campana, otro… (por defecto api).
labels	array	No	Etiquetas (se crean si no existen). Por GET o form, separadas por coma.
notes	string	No	Mensaje del formulario: queda en la línea de tiempo del contacto.

Ejemplos

Solicitud JSON

{
  "api_key": "TU_API_KEY",
  "number": "51xxxxxxxxx",
  "name": "Ana Torres",
  "email": "[email protected]",
  "company": "Empresa SAC",
  "source": "web",
  "labels": [
    "Formulario web",
    "Interesado"
  ],
  "notes": "Quiero una cotización del plan anual"
}

cURL

curl -X POST https://api.kontacto.pro/crm/contacts \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "TU_API_KEY",
    "number": "51xxxxxxxxx",
    "name": "Ana Torres",
    "email": "[email protected]",
    "company": "Empresa SAC",
    "source": "web",
    "labels": [
      "Formulario web",
      "Interesado"
    ],
    "notes": "Quiero una cotización del plan anual"
  }'

Respuesta

JSON

{
  "status": true,
  "msg": "Contacto creado",
  "data": {
    "id": "0199a3b2-7c4e-7d21-9f3a-5b8e2c1d4f60",
    "number": "51xxxxxxxxx",
    "name": "Ana Torres",
    "email": "[email protected]",
    "company": "Empresa SAC",
    "source": "web",
    "labels": [
      "Formulario web",
      "Interesado"
    ],
    "opt_out": false
  }
}

Contactos del CRM

GET https://api.kontacto.pro/crm/contacts

Parámetros · cuerpo JSON si es POST

Parámetro	Tipo	Requerido	Descripción
api_key	string	Sí	Tu API key.
number	string	Sí	Número del contacto.

Ejemplos

Solicitud JSON

{
  "api_key": "TU_API_KEY",
  "number": "51xxxxxxxxx"
}

cURL

curl -X POST https://api.kontacto.pro/crm/contacts \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "TU_API_KEY",
    "number": "51xxxxxxxxx"
  }'

Por GET

https://api.kontacto.pro/crm/contacts?api_key=TU_API_KEY&number=51xxxxxxxxx

Respuesta

JSON

{
  "status": true,
  "data": {
    "id": "0199a3b2-7c4e-7d21-9f3a-5b8e2c1d4f60",
    "number": "51xxxxxxxxx",
    "name": "Ana Torres",
    "labels": [
      "Interesado"
    ],
    "opt_out": false
  }
}

Responde 201 si el contacto es nuevo y 200 si ya existía; 404 en la consulta si no está. id es el identificador del contacto (UUID). opt_out = true indica que pidió no recibir campañas (escribió BAJA).

¿Listo para integrar?

Pide tu cuenta y tu API key por WhatsApp.

Hablar por WhatsApp Ingresar