Vitec Connect
Dokumentation för API-funktioner
POST CRM/Contact/{customerId}/Message/{contactId} Skicka SMS/Epost Request Information URI Parameters
NamnBeskrivningTypInformation
customerId Kund-id. string Krävs
contactId Kontaktid. string Krävs
Body Parameters SMS CrmContactMessage
NamnBeskrivningTypInformation
EstateId Id på bostad string Id på bostad krävs
ViewingId Id på visning string

ExternData Extra data Collection of ExternData

TypeOfMessage Typ av SMS/Epost TypeOfMessage Typ av SMS/Epost krävs
TemplateType Typ av anpassad mall string

DisplayName Avsändare SMS/Epost, hämtas från kedja eller firma om det lämnas tomt string

Reciever Mottagare (kontakt om man utelämnar) Reciever

Request Formats

{
  "estateId": "sample string 1",
  "viewingId": "sample string 2",
  "externData": [
    {
      "name": "sample string 1",
      "value": "sample string 2"
    },
    {
      "name": "sample string 1",
      "value": "sample string 2"
    }
  ],
  "typeOfMessage": "IdentifiedInterest",
  "templateType": "sample string 3",
  "displayName": "sample string 4",
  "reciever": "Contact"
}

<CrmContactMessage xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Express.Connect.Api.Models.Contact.Crm">
  <DisplayName>sample string 4</DisplayName>
  <EstateId>sample string 1</EstateId>
  <ExternData>
    <ExternData>
      <Name>sample string 1</Name>
      <Value>sample string 2</Value>
    </ExternData>
    <ExternData>
      <Name>sample string 1</Name>
      <Value>sample string 2</Value>
    </ExternData>
  </ExternData>
  <Reciever>Contact</Reciever>
  <TemplateType>sample string 3</TemplateType>
  <TypeOfMessage>IdentifiedInterest</TypeOfMessage>
  <ViewingId>sample string 2</ViewingId>
</CrmContactMessage>
Response Information Resource Description Skicka SMS/Epost

Kodexempel 

curl "https://connect.maklare.vitec.net/CRM/Contact/StringValue/Message/StringValue" -X POST -H "Content-Type: application/json" -H "Authorization: basic {Base64 kodad användarnamn och lösenord}" -d {\"estateId\":\"StringValue\",\"viewingId\":\"StringValue\",\"externData\":[{\"name\":\"StringValue\",\"value\":\"StringValue\"}]}
            

$URL = "https://connect.maklare.vitec.net/CRM/Contact/StringValue/Message/StringValue"
$data = "{`"estateId`":`"StringValue`",`"viewingId`":`"StringValue`",`"externData`":[{`"name`":`"StringValue`",`"value`":`"StringValue`"}]}"
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 = "{\"estateId\":\"StringValue\",\"viewingId\":\"StringValue\",\"externData\":[{\"name\":\"StringValue\",\"value\":\"StringValue\"}]}";
using (var response = await HttpClientInstance.PostAsync("CRM/Contact/StringValue/Message/StringValue", 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/Contact/StringValue/Message/StringValue";

$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 = "{\"estateId\":\"StringValue\",\"viewingId\":\"StringValue\",\"externData\":[{\"name\":\"StringValue\",\"value\":\"StringValue\"}]}";
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