Vai al contenuto principale
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

inquiry.json
{
  "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.