Integración de sitios web y plataformas externas con CASAFARI CRM

Actualmente, existen dos opciones principales para realizar esta integración:

1. API de CASAFARI CRM

La API permite que un sistema externo se comunique directamente con CASAFARI CRM, de acuerdo con los endpoints y funcionalidades disponibles.

La documentación técnica de la API está disponible en este enlace.

Para consultar, probar y analizar la API, deberá utilizar el siguiente token:

Authorization: Basic ZXh0ZXJuYWxkZXY6Rml0aDVmQmRmZ3NkeEhWTUF4aXpkNW9yNjhn

Con este token y URL, tendrá acceso a datos de prueba (dummy), que podrán utilizarse durante la fase de desarrollo y validación de la integración.

Una vez finalizada esta fase y cuando deseen empezar a trabajar con los datos reales de su agencia, deberán proporcionarnos la IP estática y dedicada del servidor que realizará las solicitudes a la API.

A continuación, validaremos la IP y la añadiremos a nuestra whitelist. Una vez completada esta validación, les proporcionaremos el token y la URL de producción, que permitirán el acceso a los datos reales de su agencia.

¿Por qué es necesaria una IP estática y dedicada?

Por razones de seguridad, el acceso a la API de producción solo está permitido desde IPs estáticas y dedicadas previamente autorizadas.

Esto nos permite identificar de forma consistente el origen de las solicitudes y garantizar que únicamente los servidores previamente validados puedan acceder a los datos de la agencia.

Por este motivo, no se aceptan IPs dinámicas o compartidas, ni IPs que puedan ser utilizadas por varios servidores, ya que no permiten garantizar el mismo nivel de control y seguridad. Por lo tanto, las IPs dinámicas y/o compartidas no se añadirán a nuestra whitelist.

Preguntas frecuentes

¿Existen límites en el número de llamadas a la API o costes adicionales asociados al uso de la API de producción?

No. Actualmente, no existen límites en el número de llamadas a la API ni costes adicionales asociados a la conexión de producción.

¿Es posible almacenar en caché las respuestas de la API en el servidor para mejorar el rendimiento del sitio web?

Sí. Es posible utilizar una caché en el servidor para las respuestas de la API.

Como recomendación general, sugerimos un periodo de caché de entre 15 minutos y 1 hora, dependiendo de las necesidades de la integración. Si la información de las propiedades no cambia con frecuencia en su caso de uso específico, también se puede utilizar un periodo de caché más largo.

¿Existe algún método recomendado para mantener sincronizados los datos de las propiedades del sitio web con el CRM?

El enfoque recomendado depende de los endpoints utilizados y de las necesidades específicas de la integración.

Para sitios web que necesiten mantener los datos de las propiedades actualizados regularmente, recomendamos utilizar los mecanismos disponibles en la API para obtener la información más reciente, evitando realizar solicitudes repetidas para obtener el conjunto completo de propiedades.

¿Todos los endpoints y servicios de la API están disponibles?

No. El acceso depende de los permisos asociados al token.

Deberá indicarnos qué funcionalidades necesita (por ejemplo, consultar propiedades, crear leads o consultar leads), para que podamos configurar los permisos correspondientes.

¿Es posible añadir más de una IP de producción a la whitelist?

Sí. Es posible añadir hasta dos IPs estáticas y dedicadas a nuestra whitelist.

Esto permite, por ejemplo, configurar un entorno principal y un entorno de failover, utilizando una IP dedicada para cada servidor.

2. Feed

Como alternativa a la API, es posible proporcionar un feed de propiedades mediante una URL, que podrá ser utilizado por el sistema externo para obtener los datos de las propiedades.

Actualmente, están disponibles los siguientes formatos:

• ACME-CRM – documentación disponible en este enlace.
• KYERO
• XML2U

El formato más adecuado dependerá de las necesidades y de las capacidades técnicas del sistema que recibirá el feed.

Integración de leads

Existen dos opciones para integrar leads:

• API – documentación disponible en este enlace.
• Formato de email

Para poder recibir leads de cualquier otra fuente, es necesario que se envíe un email a agencyname@feedcruncher.com, utilizando el siguiente formato:

Name: 
Email: 
Phone: 
Origin: 
Message: 
Reference: 

Estos campos deben estar completamente cumplimentados y no pueden modificarse ni traducirse a otros idiomas.

Cuando se utiliza este formato, el CRM podrá importar los leads y crear automáticamente el origen correspondiente en el sistema.

Nota: El feed se actualiza cada 20 minutos.

Integración con WordPress

CASAFARI CRM no dispone actualmente de un plugin oficial para WordPress.

Además, no ofrecemos soporte directo para la configuración o el desarrollo de servicios externos. Esto significa que la conexión entre el sitio web y CASAFARI CRM no es automática.

Para que el sitio web pueda comunicarse con CASAFARI CRM, será necesario que un programador desarrolle una integración personalizada, utilizando la API o el feed proporcionado por el CRM.

Este desarrollo deberá ser realizado por un programador o equipo técnico de su elección.

¿No dispone de un equipo técnico?

Si no dispone de un equipo técnico interno para realizar la integración, podemos recomendarle uno de nuestros partners certificados, que conocen nuestro sistema y pueden ofrecer este servicio mediante una tarifa de configuración.

¿Cuál es la mejor opción?

La elección entre API y feed depende del objetivo de la integración:

• API: recomendada cuando se necesita una comunicación más dinámica entre el sitio web y el CRM, o cuando es necesario crear o consultar información mediante los endpoints disponibles.

• Feed: recomendado cuando el principal objetivo es poner a disposición de un sistema externo, como un sitio web o portal, los datos de las propiedades disponibles en el CRM.

El programador responsable de la integración deberá analizar los requisitos del sitio web y determinar cuál de las opciones es la más adecuada.

Si necesita alguna aclaración o soporte adicional sobre la integración, puede contactar con nuestro equipo a través de help@casafaricrm.com.