¿Cómo configurar la API Key y los webhooks en el CRM? | Base de conocimiento 2clics CRM Inmobiliario

La API Key y los webhooks te permiten conectar el CRM con otros sistemas. Con una API Key, una aplicación autorizada puede consultar o cargar información. Con los webhooks, podés recibir avisos automáticos cuando se crea, edita o elimina una propiedad, un negocio, un emprendimiento o un contacto.

Así, la información se mantiene actualizada entre sistemas y evitás copiar datos manualmente.

¿Dónde se configuran?

Para comenzar, ingresá a Integraciones desde el CRM.

Una vez allí, seleccioná API y Webhooks.

Vamos a encontrar dos secciones: una para generar la API Key y otra para configurar los eventos que querés recibir por webhook.

¿Cómo generar una API Key?

Si todavía no tenés una clave, hacé clic en Generar API Key dentro de la sección API KEY. Una vez generada, podrás verla en esa misma sección.

Una vez generada, vas a verla en esa misma sección la clave aparece oculta. Podés usar el ícono del ojo para verla y el botón Copiar para copiarla. También podés Regenerar API Key si necesitás reemplazarla, o Eliminar API Key si ya no querés utilizarla.

¿Cómo configurar un webhook?

Debajo de API KEY, vas a encontrar la sección Webhook. Para configurarlo:

Ingresá una dirección HTTPS pública en URL del endpoint.
Verificá que esté marcada la opción Webhook activo.
En Eventos a enviar, seleccioná los avisos que querés recibir.
Hacé clic en Guardar webhook.

Una vez guardado, vas a ver la Clave de firma. Podés mostrarla con el ícono del ojo o usar Copiar para compartirla con quien configure la recepción del webhook.

Si desactivás Webhook activo, el CRM dejará de enviar los eventos seleccionados.

Eventos disponibles

Propiedad: crm.property.created, crm.property.updated, crm.property.deleted
Negocio: crm.deal.created, crm.deal.updated, crm.deal.deleted
Emprendimiento: crm.development.created, crm.development.updated, crm.development.deleted
Contacto: crm.contact.created, crm.contact.updated, crm.contact.deleted

Ejemplos de notificaciones

Cada aviso contiene el evento (type), la fecha en que ocurrió (occurredAt), la inmobiliaria (realEstateId) y los datos de la ficha (data).

Importante: Los JSON son ejemplos ilustrativos. Los campos y valores de cada notificación pueden variar según la información cargada en el CRM y el evento que se haya producido.

Propiedad creada

{   
  "type": "crm.property.created",
  "occurredAt": "2026-10-08T20:00:00.000Z",   
  "realEstateId": 77,   
  "data": {     
    "propertyId": 177101, 
    "property": {   
       "propertyId": 177101,  
       "address": "Av. Corrientes 1234",    
       "operationType": "VENTA",    
       "price": 150000,   
       "currency": "USD",      
       "agent": {      
         "userId": 7901,         
         "fullName": "María García",  
         "cellphone": "1123456789"       
       },       
       "images": [         
         {           
           "imageId": "3788290",           
           "name": "frente.jpg",
           "url": "https://ejemplo.com/frente.jpg"
         }
       ]
     }
   }
 }

Negocio creado

{
   "type": "crm.deal.created",
   "occurredAt": "2026-10-08T20:05:00.000Z",
   "realEstateId": 77,
   "data": {
     "dealId": 696365,
     "deal": {       "dealId": 696365,
       "name": "Consulta por departamento",
       "status": "OPEN",
       "origin": {
         "originId": 1,
         "name": "Zonaprop"
       },
       "lead": {
         "personId": 736494,
         "fullName": "Juan Pérez",
         "email": "[email protected]",
         "phoneOne": "1123456789"
       },
       "propertyIds": [177101],
       "developmentIds": []
     }
   }
 }

Emprendimiento creado

{
   "type": "crm.development.created",
   "occurredAt": "2026-10-08T20:10:00.000Z",
   "realEstateId": 77,
   "data": {
     "developmentId": 1227,
     "development": {
       "developmentId": 1227,
       "title": "Edificio Central",
       "address": "Av. Corrientes",
       "number": "1234",
       "images": [
         {
           "imageId": 3788300,
           "name": "fachada.jpg",
           "url": "https://ejemplo.com/fachada.jpg"
         }
       ],
       "amenities": [],
       "plans": [],
       "units": [],
       "landlordIds": []
     }
   }
 }

Contacto creado

{
   "type": "crm.contact.created",
   "occurredAt": "2026-10-08T20:15:00.000Z",
   "realEstateId": 77,
   "data": {
     "contactId": 736496,
     "contact": {
       "personId": 736496,
       "fullName": "Ana López",
       "phoneOne": "1123456789",
       "email": "[email protected]",
       "classification": "LANDLORD",
       "propertyIds": [177101],
       "developmentIds": []
     }
   }
 }

Para una edición o eliminación se conserva esta estructura y cambia el valor de type a .updated o .deleted. En una eliminación, data contiene los últimos datos disponibles de la ficha. crm.deal.updated también puede incluir las notas y actividades del negocio.