In fase di lancioAggiornato al 19 novembre 2026
Richieste come JSON via e-mail
Ogni richiesta come un'e-mail all'indirizzo che ci indichi. Il testo dell'e-mail è il JSON, il tuo software lo legge.
L'e-mail
Un’e-mail per ogni nuova richiesta, in testo semplice UTF-8, il cui intero testo è un oggetto JSON. Va all’indirizzo che ci indichi per i tuoi annunci. L’oggetto è «Homematch Anfrage» seguito dall’inquiryId, e il Reply-To è la persona che chiede. I messaggi successivi non arrivano in JSON.
Rispondere direttamente
E-mail e telefono della persona che fa la richiesta sono reali, così la tua agenzia può rispondere direttamente.
Campi
versionstring- Sempre "1". Annunceremo una nuova versione.
sourcestring- Sempre "homematch".
inquiryIdstring- Identificativo univoco della richiesta. Se arriva due volte, è la stessa.
sentAtstring- Quando è stata inviata la richiesta (ISO 8601).
listing.providerReferencestring | null- Il tuo riferimento dell'immobile, dal tuo feed.
listing.homematchListingIdstring- Il numero dell'annuncio su Homematch.
listing.urlstring- Il link all'annuncio.
listing.addressstring | null- L'indirizzo dell'immobile, su una riga.
inquirer.firstNamestring | null- Nome.
inquirer.lastNamestring | null- Cognome.
inquirer.emailstring- E-mail della persona che fa la richiesta.
inquirer.phonestring | null- Telefono, se indicato.
inquirer.languagestring- Lingua della persona: de, fr, it o en.
messagestring- Il messaggio, così come è stato scritto.
profileobject | null- Il profilo di candidatura, se la persona ne invia uno.
profile.dealstring- rent o sale.
profile.topicsstring[]- Quali dati contiene il profilo, mai i dati stessi.
conversationUrlstring | null- Sempre null via e-mail: rispondi direttamente all’indirizzo della persona.
Cosa può indicare topics
Solo il tipo di dato, mai il valore:
- household
- pets
- employment
- income
- moveIn
- purchasePurpose
- equity
- financing
Esempio
{
"version": "1",
"source": "homematch",
"inquiryId": "7d0f3c2a5b1e4c8d9f6a2e4b8c1d0a93",
"sentAt": "2026-11-19T13:32:05Z",
"listing": {
"providerReference": "R-1234",
"homematchListingId": "1234567",
"url": "https://homematch.ch/listings/1234567",
"address": "Musterstrasse 12, 8000 Zürich"
},
"inquirer": {
"firstName": "Anna",
"lastName": "Muster",
"email": "anna.muster@example.invalid",
"phone": "+41 79 000 00 00",
"language": "de"
},
"message": "Guten Tag, ist die Wohnung noch frei? Ich würde sie gerne besichtigen.",
"profile": {
"deal": "rent",
"topics": [
"household",
"employment",
"income",
"moveIn"
]
},
"conversationUrl": null
}Pronto per il test?
Ti diamo accesso al nostro ambiente di test e verifichiamo il tuo collegamento prima che vada online.