Vitec Connect
Dokumentation för API-funktioner
POST CRM/Estate/{customerId}/{estateId}/CustomerSatisfaction Sparar ett enkätsvar som visar hur nöjd en kund utifrån rollen som visningsdeltagare, säljare eller köpare var med handläggarens arbete. Request Information URI Parameters
NamnBeskrivningTypInformation
customerId Kundid string Krävs
estateId Id för objekt kopplat till den affär som enkätsvaret avser string Krävs
Body Parameters Innehåller uppgifter om kundens enkätsvar CustomerSatisfactionSurvey
NamnBeskrivningTypInformation
ReportDate Datum då enkäten utfördes eller datum då kunden träffade handläggaren. Om värdet utelämnas kommer dagens datum användas. Datumet används i periodeiseringen för beräkningen av nyckeltal för en handläggare eller ett kontor. date

ContactId Id på kunden som lämnar enkätsvaret. string Id för kontakten som lämnar enkätsvaret måste anges
IsAnonymous Anger om enkätsvaret skall behandlas anonymt eller ej. Om enkätsvaret är anonymt visas det inte på kontaktkortet i systemet, men kommer ändå att ligga till grund för beräkning av nyckeltal för handläggaren. boolean Ange om enkätsvaret skall behandlas anonymt eller ej
AgentId Id på handläggare som enkätsvaret avser. Om värdet utelämnas antas svaret avse ansvarig handläggare på bostaden. string

ParticipantRole Anger om kunden som svarade på enkäten är visningsdeltagare, säljare eller köpare. SurveyParticipantRole Ange om kunden som svarade på enkäten är köpare, säljare eller visningsdeltagare
Result Resultat på enkätsvaret, dvs det värde som angavs i enkäten. integer Ett värde mellan 0 och 100 måste anges för enkätsvaret.
CalculatedResult Beräknat värde utifrån enkätsvaret. Om enkätsvaret konverteras till annan skala anges det konverterade värdet, annars anges enkätsvaret även i detta fält. Om systemet INTE skall användas för att beräkna nyckeltal utifrån enkäter utelämnas fältet. CalculatedResult

Request Formats

{
  "reportDate": "2024-11-21T11:23:11.2404291+01:00",
  "contactId": "sample string 1",
  "isAnonymous": true,
  "agentId": "sample string 3",
  "participantRole": "Buyer",
  "result": 1,
  "calculatedResult": {
    "value": 1,
    "method": "NPS"
  }
}

<CustomerSatisfactionSurvey xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Express.Connect.Api.Models.CustomerSatisfaction">
  <AgentId>sample string 3</AgentId>
  <CalculatedResult>
    <Method>NPS</Method>
    <Value>1</Value>
  </CalculatedResult>
  <ContactId>sample string 1</ContactId>
  <IsAnonymous>true</IsAnonymous>
  <ParticipantRole>Buyer</ParticipantRole>
  <ReportDate>2024-11-21T11:23:11.2404291+01:00</ReportDate>
  <Result>1</Result>
</CustomerSatisfactionSurvey>
Response Information Resource Description Sparar ett enkätsvar som visar hur nöjd en kund utifrån rollen som visningsdeltagare, säljare eller köpare var med handläggarens arbete.

Kodexempel 

curl "https://connect.maklare.vitec.net/CRM/Estate/StringValue/StringValue/CustomerSatisfaction" -X POST -H "Content-Type: application/json" -H "Authorization: basic {Base64 kodad användarnamn och lösenord}" -d {\"reportDate\":\"2015-01-01T12:00:00\",\"contactId\":\"StringValue\",\"isAnonymous\":false}
            

$URL = "https://connect.maklare.vitec.net/CRM/Estate/StringValue/StringValue/CustomerSatisfaction"
$data = "{`"reportDate`":`"2015-01-01T12:00:00`",`"contactId`":`"StringValue`",`"isAnonymous`":false}"
Invoke-WebRequest -Uri $URL -Method POST -Headers @{"Content-Type" = "application/json"; "authorization" = "basic {Base64 kodad användarnamn och lösenord}"} -Body $data
                

// HttpClientInstance ska deklareras som en singleton
// public static readonly HttpClient HttpClientInstance = new HttpClient {
//     BaseAddress = new Uri("https://connect.maklare.vitec.net"),
//     DefaultRequestHeaders = {
//         Authorization = new AuthenticationHeaderValue("Basic", "{Base64 kodad användarnamn och lösenord}")
//     }
// }
var json = "{\"reportDate\":\"2015-01-01T12:00:00\",\"contactId\":\"StringValue\",\"isAnonymous\":false}";
using (var response = await HttpClientInstance.PostAsync("CRM/Estate/StringValue/StringValue/CustomerSatisfaction", new StringContent(json, Encoding.UTF8, "application/json"))) {
    if (response.StatusCode == HttpStatusCode.Unauthorized) {
        // Authorization headern är inte korrekt
    }
    if (response.StatusCode == HttpStatusCode.Forbidden) {
        // Begärt data som det saknas åtkomst till
    }
    if (response.StatusCode == HttpStatusCode.InternalServerError) {
        // Oväntat fel, kontakta Vitec
    }
    if (response.StatusCode == HttpStatusCode.BadRequest) {
        var json = await response.Content.ReadAsStringAsync();
        var result = JsonConvert.DeserializeObject<dynamic>(json);
        // Hantera valideringsfel, presenteras i resultatet
    }
}


$URL = "https://connect.maklare.vitec.net/CRM/Estate/StringValue/StringValue/CustomerSatisfaction";

$ch = curl_init();

curl_setopt($ch, CURLOPT_USERNAME, "{Användarnamn}");
curl_setopt($ch, CURLOPT_PASSWORD, "{Lösenord}");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_URL, $URL);
$data = "{\"reportDate\":\"2015-01-01T12:00:00\",\"contactId\":\"StringValue\",\"isAnonymous\":false}";
curl_setopt($ch, CURLOPT_POST, true);

curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
    'Content-Type: application/json',
    'Content-Length: ' . strlen($data)
));

$result = curl_exec($ch);

if (curl_errno($ch)) {
    die(curl_getinfo($ch));
}

$info = curl_getinfo($ch);
curl_close($ch);

$http_code = $info["http_code"];
if ($http_code == 401) {
    // Användarnamnet eller lösenordet är felaktigt
}
if ($http_code == 403) {
    // Begärt data som det saknas åtkomst till
}
if ($http_code == 500) {
    // Oväntat fel, kontakta Vitec
}
if ($http_code == 400) {
    $json = json_decode($result, true);
    // Hantera valideringsfel, presenteras i $json
}
Testformulär Text input