Just Invest Here

Guide complet du système — Bot + Site web + CRM

EN ES FR

Sommaire

  1. Vue d'ensemble du système
  2. Comment ajouter un nouveau bien
  3. Photos et vidéos
  4. Publier et dépublier
  5. Synchronisation automatique CRM → Site web
  6. Biens VIP et de luxe
  7. Gestion de l'équipe
  8. Articles d'actualités (Blog)
  9. Newsletter
  10. Flux Idealista et JamesEdition
  11. Commandes du bot Telegram
  12. Pages et langues du site
  13. Référence des tableaux Monday.com
  14. Tâches à long terme
  15. Modifications (8 avril → 5 mai)

1. Vue d'ensemble du système

Le système comporte trois parties connectées :

Bot Telegram

Les agents de terrain créent des biens, des leads et des transactions directement depuis leur téléphone. Assistant en 15 étapes avec téléchargement de photos.

CRM Monday.com

Base de données centrale pour tous les biens, leads, transactions et membres de l'équipe. Source unique de vérité.

Site web

justinvesthere.com — site immobilier de luxe public disponible en 3 langues (ES, EN, FR).

Flux

Flux JSON Idealista et XML JamesEdition générés automatiquement depuis la base de données du site.

Comment ils se connectent

Agent (Telegram) Bot CRM Monday.com Site web + Flux

Toute modification effectuée dans Monday.com est synchronisée automatiquement avec le site en quelques secondes.

2. Comment ajouter un nouveau bien

Option A : via le bot Telegram (pour les agents de terrain)

Ouvrez le bot, appuyez sur le bouton menu, sélectionnez /nueva. Suivez les 15 étapes :

Étapes 1–3 : Informations client

Nom, e-mail, téléphone → crée un Lead dans Monday.com

Étapes 4–5 : Type

Transaction (Venta/Alquiler) + Type de bien (Piso, Casa, Chalet, etc.)

Étapes 6–10 : Détails

Adresse, ville, prix, commission, surface, chambres, salles de bain

Étape 11 : Description

Description libre (utilisée pour le texte d'annonce amélioré par IA)

Étape 12 : Révision

Vérifier toutes les données, confirmer ou modifier

Étape 13 : Contrat

Contrat DocuSign optionnel (Standard ou Exclusif)

Étape 14 : Photos

Téléchargez jusqu'à 50 photos (envoyez-les en tant que fichiers pour une qualité optimale)

Étape 15 : Publier

Sélectionnez les plateformes : Site web, Idealista, JamesEdition

Option B : directement dans Monday.com

Étape 1

Ajoutez un nouvel élément au tableau Properties

Étape 2

Remplissez toutes les colonnes : type, adresse, prix, surface, chambres, salles de bain, description

Étape 3

Téléchargez les photos dans la colonne fichier « Fotos »

Étape 4

Cochez les cases de publication (Publicar Web, Publicar Idealista, etc.)

Étape 5

Mettez « Listo para Publicar » sur Listo → publication automatique

3. Photos et vidéos

Tous les médias sont téléversés sur l'élément du bien dans Monday.com. Le site les récupère en quelques secondes — aucun téléversement séparé sur le site n'est nécessaire.

Photos

Ouvrez l'élément du bien dans Monday → colonne fichier Fotos → glissez-déposez ou collez depuis le presse-papiers.

Formats

JPG, PNG, WebP, HEIC tous acceptés. Les photos HEIC d'iPhone sont converties en JPEG automatiquement — pas besoin de les exporter en JPG vous-même.

Quantité

Jusqu'à 50 par bien via le bot Telegram, illimité via le téléversement Monday. Recommandé : 15–30 photos — plus, cela pénalise le temps de chargement.

Ordre

La première photo dans Monday est la couverture (utilisée sur la carte du listing et comme photo principale sur la page de détail). Glissez les photos dans Monday pour les réordonner.

Résolution et poids

Les originaux peuvent avoir n'importe quelle taille — le site génère automatiquement des variantes responsives via Cloudflare Image Transformations (400, 800, 1200, 1600, 2400 px de large). Les visiteurs ne téléchargent que ce dont leur appareil a besoin.

Plans

Marquez une photo comme plan dans Monday (colonne Tipo de Foto = « Plano ») — elle s'affiche dans une section dédiée « Plans » sur la page du bien plutôt que dans la galerie principale.

Vidéos

Trois options — choisissez celle dont vous disposez :

OptionComment ajouterIdéal pour
Lien YouTube / Vimeo Collez l'URL publique dans la colonne Video URL de Monday. Vidéos de visite, prises de drone, présentations d'agent — tout ce qui dépasse 100 Mo.
Téléversement MP4 Joignez le fichier à la colonne Video. Restez sous 100 Mo. Clips courts (moins d'une minute), prises aériennes.
Visite 360° / Matterport Collez l'URL d'embed dans la colonne Tour URL. Visites virtuelles, Kuula, Matterport, iGuide.

Les vidéos s'affichent au-dessus de la galerie photo sur la page de détail du bien. Si un MP4 et un lien YouTube sont tous deux présents, le MP4 est utilisé et YouTube est proposé en lien de repli.

Astuce : pour le flux JamesEdition, un MP4 ou un lien YouTube est requis — les biens sans vidéo sont acceptés mais moins bien classés sur leur portail.

4. Publier et dépublier

Action dans Monday.com Ce qui se passe Vitesse
Mettre « Listo para Publicar » → Listo Le bien est publié sur toutes les plateformes sélectionnées Automatique — secondes
Mettre « Listo para Publicar » → No Listo Le bien est retiré du site et de tous les flux Automatique — secondes
Mettre « Listo para Publicar » → Bloqueado Identique à No Listo — le bien est archivé Automatique — secondes
Changer le statut en Vendido Le bien est marqué comme vendu sur le site Automatique — secondes
Colonnes clés qui contrôlent la publication :
Publicar Web (Publier sur le site) — afficher sur justinvesthere.com
Publicar Idealista — inclure dans le flux Idealista
Publicar JamesEdition — inclure dans le flux JamesEdition
Listo para Publicar — interrupteur principal (doit être sur « Listo » pour publier)

5. Synchronisation automatique CRM → Site web

Chaque modification que vous apportez à un bien dans Monday.com met automatiquement à jour le site.

Modifier une colonne dans Monday Webhook déclenché (debounce 3 s) Le bot synchronise les données Site mis à jour

Ce qui est synchronisé automatiquement

ChampColonne Monday.com
PrixPrecio
DescriptionDescripción
PhotosFotos (colonne fichier)
Chambres / Salles de bain / SurfaceHabitaciones, Baños, Superficie
Type de bienTipo (Piso, Casa, etc.)
Type de transactionTipo de Operación
ÉquipementsPiscina, Jardín, Terraza, A/C, etc.
Indicateurs VIP / LuxeDestacado (VIP), Lujo
Classe énergétiqueClasificación Energética
Indicateurs de publicationPublicar Web / Idealista / JamesEdition

Aucune action manuelle nécessaire — modifiez simplement dans Monday.com et le site se met à jour automatiquement.

6. Biens VIP et de luxe

Case à cocher dans MondayEffet sur le site
Destacado (VIP) Le bien apparaît dans le carrousel Biens à la une de la page d'accueil (les 3 premiers sont affichés)
Lujo Le bien apparaît dans la section Prestige Collection et sur la page /luxury avec un badge luxe

Il suffit de cocher la case dans Monday.com — le site se met à jour automatiquement.

7. Gestion de l'équipe

Les membres de l'équipe sont gérés dans le tableau Team Members de Monday.com (ID : 5094178524).

Pour ajouter un nouveau membre de l'équipe

Étape 1

Ajoutez un nouvel élément au tableau Team Members. Le nom de l'élément est le nom complet de la personne.

Étape 2

Remplissez : Titre (ES/EN/FR), E-mail, Téléphone, Photo, LinkedIn, Langues, Localisation

Étape 3

Cochez les cases Activo et Publicar Web

Étape 4

Réglez Orden (ordre d'affichage) — 1 apparaît en premier

La section équipe du site se met à jour automatiquement dès qu'une colonne change.

Colonnes du tableau d'équipe

ColonneFinalité
Título (ES/EN/FR)Intitulé du poste en 3 langues
EmailE-mail de contact
TeléfonoNuméro de téléphone
FotoPhoto de profil (téléchargée sur Monday)
LinkedInURL du profil LinkedIn
IdiomasLangues parlées
UbicaciónVille/pays
Bio (ES/EN/FR)Biographie en 3 langues
OrdenOrdre d'affichage (1 = premier)
ActivoDoit être coché pour apparaître
Publicar WebDoit être coché pour s'afficher sur le site

8. Articles d'actualités (Blog)

Les articles publiés sur /news sont gérés dans le groupe News du tableau Properties (ou un tableau News dédié si vous préférez — demandez à Dev de le scinder). Chaque article gère 3 langues et une image à la une.

Pour publier un nouvel article

Étape 1

Dans Monday, créez un nouvel élément. Le nom de l'élément est le slug (partie de l'URL) — p. ex. guide-investir-ibiza-2026. Minuscules, tirets, sans accents.

Étape 2

Remplissez les colonnes de langue :

  • Title (ES / EN / FR) — le titre de l'article.
  • Excerpt (ES / EN / FR) — 1 ou 2 phrases affichées sur la carte du listing news.
  • Body (ES / EN / FR) — l'article complet. Texte brut ou HTML basique.
  • Category (ES / EN / FR) — p. ex. « Mercado » / « Market » / « Marché ».
Étape 3

Téléversez une image à la une (colonne fichier) — format paysage, min. 1200×800. Elle devient la couverture sur le listing et l'en-tête de la page article.

Étape 4

Renseignez Published At (colonne date) et passez Status à Published. Cochez Publicar Web.

Étape 5

En 5 minutes environ, l'article apparaît sur /news/votre-slug (et /en/news/votre-slug, /fr/news/votre-slug).

Valeurs de Status

StatusEffet
DraftMasqué du site public. À utiliser pendant la rédaction.
PublishedEn ligne sur /news dans les langues que vous avez remplies.
ArchivedRetiré du listing mais l'URL reste valide (pour ne pas casser les anciens liens).
Repli linguistique : si vous remplissez seulement le titre/corps en espagnol, l'article n'apparaît que sur /news. Pour qu'il soit visible sur /en/news et /fr/news, remplissez aussi ces langues — ou laissez-les vides si l'article est volontairement uniquement en espagnol.

9. Newsletter

État : partiellement construit. La base de données du site dispose d'une table subscribers prête à recevoir des e-mails, mais le formulaire d'inscription sur le site public et le pipeline d'envoi ne sont pas encore implémentés.

Ce qui marche aujourd'hui

Rien de visible pour le visiteur. Le schéma est en place ; pas d'UI ; pas de fournisseur connecté.

Pour activer cela, nous avons besoin de trois décisions de votre part

DécisionOptions
Fournisseur d'e-mailing Mailchimp, Brevo (ex-Sendinblue), Resend, Beehiiv, ConvertKit. Choisissez-en un — nous l'intégrons.
Où le formulaire apparaît Pied de page seulement, ou aussi en popup à la deuxième visite, ou en ligne au bas des articles d'actualités.
Qui rédige et envoie chaque numéro Vous ? Nous ? Fréquence : mensuelle, trimestrielle, ou seulement lors des lancements de biens.

Une fois décidé, voici ce que nous construirons

A

Composant de formulaire d'inscription (pied de page + en ligne en option). Un seul champ e-mail, consentement RGPD, e-mail de confirmation double opt-in.

B

Endpoint POST /api/subscribe qui écrit dans la table subscribers et pousse vers la liste du fournisseur choisi.

C

Export unique des abonnés existants (s'il y en a) vers le nouveau fournisseur.

D

Un petit guide à part sur la manière d'envoyer des campagnes depuis le tableau de bord du fournisseur choisi.

Effort estimé : 1 à 2 heures de dev une fois le fournisseur choisi.

10. Flux Idealista et JamesEdition

PortailURL du fluxÉtat
Idealista justinvesthere.com/api/feeds/idealista.json Actif — schéma V6, photos HEIC converties en JPEG automatiquement.
JamesEdition justinvesthere.com/api/feeds/jamesedition.xml Actif — seuls les biens ayant Publicar JamesEdition coché y figurent.

Les flux sont générés automatiquement depuis la base de données du site. Lorsque vous publiez ou dépubliez un bien dans Monday.com avec la case Idealista ou JamesEdition, il apparaît ou disparaît du flux automatiquement.

Idealista interroge l'URL du flux périodiquement. Aucun envoi manuel nécessaire.

11. Commandes du bot Telegram

CommandeAction
/startMessage de bienvenue, demande d'accès
/nuevaDémarrer la création d'un bien en 15 étapes
/syncSynchroniser tous les biens avec le site
/cancelAnnuler la conversation en cours
/statusAfficher la progression de la conversation
/resumeReprendre une conversation interrompue

Ces commandes apparaissent dans le bouton de menu (☰) de Telegram pour un accès facile.

Autorisation : les nouveaux utilisateurs doivent être approuvés avant de pouvoir utiliser le bot. Actuellement autorisés : Oleh Veheria, Vicente Martinez. Pour ajouter un nouvel agent, fournissez son ID utilisateur Telegram.

12. Pages et langues du site

Le site est disponible en 3 langues. L'espagnol est la langue par défaut (sans préfixe d'URL).

PageEspagnolAnglaisFrançais
Accueil//en/fr
Biens/properties/en/properties/fr/properties
Luxe/luxury/en/luxury/fr/luxury
Actualités/news/en/news/fr/news
Équipe/team/en/team/fr/team
Contact/contact/en/contact/fr/contact

Pages de localisation : /locations/valencia, /locations/ibiza, /locations/zanzibar

Bientôt disponible : Dubaï, Costa Blanca, Sud de la France

13. Référence des tableaux Monday.com

TableauIDFinalité
Properties2112025682Toutes les annonces immobilières
Leads2112025567Contacts clients
Deals2112025532Transactions actives
Conversations5084545513Suivi des conversations du bot
Team Members5094178524Équipe (synchronisée avec le site)
Testimonials5094195204Témoignages clients (synchronisés avec la page d'accueil)

14. Tâches à long terme

Les décisions au quotidien vivent dans Monday.com et le STATE.yaml du projet. Cette liste est destinée aux points structurels et de plus long terme.

Contenu et qualité des données

#TâcheQuiStatut
1 Coordonnées GPS pour les marqueurs de carte
Les biens sans Latitud / Longitud dans Monday n'affichent pas de marqueur sur la page détail. Clic droit sur Google Maps pour copier les coordonnées, à coller dans Monday.
Agent Optionnel
2 Revoir les descriptions des biens
Les biens créés par le bot ont souvent un texte bref auto-généré. Peaufinez la colonne Descripción dans Monday — les changements se synchronisent automatiquement avec le site.
Agent Recommandé
3 Traduire toutes les descriptions en EN + FR
L'espagnol est la langue par défaut ; en l'absence de texte EN/FR, l'espagnol s'affiche sur les pages localisées. Pour la meilleure UX (et le SEO), remplissez les trois.
Agent / Dev (auto-traduction) Recommandé

Distribution

#TâcheQuiStatut
4 Pipeline newsletter
Choisissez un fournisseur (Mailchimp / Brevo / Resend / Beehiiv), confirmez où le formulaire doit apparaître et décidez qui rédige les campagnes. Voir la section 9.
Vicente Décision
5 Destinations « Bientôt disponible »
Dubaï, Costa Blanca et Sud de la France sont affichés comme « Bientôt disponible ». Dès que vous ajoutez un bien avec l'une de ces villes dans Monday, la destination devient active automatiquement.
Vicente À définir
6 Sélection JamesEdition (récurrent)
Pour chaque nouveau bien de luxe : cochez Publicar JamesEdition s'il a sa place dans le flux JE (portail premium, uniquement vos meilleures annonces).
Vicente Récurrent

Équipe et accès

#TâcheQuiStatut
7 Ajouter des agents de terrain au bot Telegram
Pour chaque nouvel agent : ouvrir Telegram, message à @userinfobot, envoyer l'ID numérique à Dev. Ajouté immédiatement, sans redéploiement.
Vicente + Dev Récurrent
8 Liens réseaux sociaux (LinkedIn + Google Business)
Pour le pied de page du site et le SEO. Envoyez les URLs une fois et nous les câblons.
Vicente Nécessaire

Technique (à la charge de Dev)

#TâcheQuiStatut
9 Envoi des e-mails du formulaire de contact via Resend
Les soumissions sont enregistrées en BD ; le transfert par e-mail vers vicente@justinvesthere.com nécessite la vérification du domaine sur Resend.
Dev Technique
10 Restaurer l'hébergement du guide à jih.futurist.systems/todo
L'origine renvoie actuellement une erreur de handshake SSL. Rétablir le pipeline de déploiement (CF Pages ou Worker) et le documenter.
Dev Technique

15. Modifications (8 avril → 5 mai 2026)

Faits marquants des quatre dernières semaines de travail. L'historique antérieur est dans git log.

Pipeline médias

✓ Les photos HEIC fonctionnent de bout en bout (F6) — les fichiers HEIC d'iPhone sont désormais convertis en JPEG automatiquement via Cloudflare Image Transformations. Le flux Idealista et la galerie s'affichent correctement même quand un agent envoie directement depuis son téléphone. Correctif ponctuel appliqué à l'ancien catalogue (prop-24).
✓ Cloudflare Image Transformations activé — sur le plan Free (5 000 transformations uniques / mois). Les images des cartes de bien sont redimensionnées via /cdn-cgi/image, ce qui corrige les cartes cassées dues à des originaux R2 trop volumineux.
✓ Support vidéo livré — les biens peuvent désormais avoir des liens YouTube/Vimeo, des téléversements MP4 ou des embeds de visite 360°. Affiché au-dessus de la galerie photo sur la page détail. Inclus dans le flux Idealista V6 lorsque présent.
✓ Carte de bien améliorée — affiche year_built et un chip de type de bien localisé (Casa / Villa / Appartement …).

Actualités et contenu

✓ Les articles d'actualités viennent désormais de Monday — le blog /news n'est plus codé en dur. Les articles sont gérés dans le CRM avec des champs en 3 langues, status (Draft/Published/Archived) et une image à la une. Voir la section 8.
✓ Pages légales traduites — Confidentialité et Conditions existent désormais en EN et ES (en plus du FR).

Infrastructure

✓ Domaine sur Cloudflare — le DNS de justinvesthere.com migré vers Cloudflare le 30 avril 2026. Propagation plus rapide, protection DDoS gratuite, prérequis pour Image Transformations.
✓ Vue « Add new property » dans Monday — un formulaire propre pour les nouveaux biens (au lieu d'éditer le large tableau Monday directement). Créée via l'API Monday ; colonnes pré-groupées et champs obligatoires imposés.

Qualité

✓ CI renforcée — tests + build s'exécutent sur chaque PR (GitHub Actions). Revue Codex avec auto-merge si le run est propre.