Page tree
Skip to end of metadata
Go to start of metadata
 

Mit der Veröffentlichung von TecArt Version 4.10 wird diese Version des REST Webservice nicht weiterentwickelt, steht aber zu Zwecken der Abwärtskompatibilität weiter zur Verfügung. 

With the release of TecArt version 4.10 this version of REST Webservice will no longer receive further development, yet will stay available for reasons of downward compatibility.

1. Aufruf URL

http://hostname/dirname/rest/index.php/cti

e.g. https://test.tecart-system.de/rest/index.php/cti

2. Klasse

crmcti

3. Methoden

3.1. crmaddCall

Syntax:

int crmaddCall( string $session_id, array $crmCallItem )

Beschreibung:

Fügt einen Anruf hinzu und erzeugt ein Event zum automatischen Öffnen eines Anruf-Fensters.

Voraussetzung zum Öffnen des Anruf-Fensters ist ein aktivierter CTI-Service unter Administration→Telefon/CTI→CTI Service

Gibt eine call_id zurück und wirft eine Exception im Fehlerfall.

'Eigenschaften von $crmCallItem:

Type(Length)            Eigenschaft               Beschreibung
---------------------------------------------------------------------------------------------
string(255)             $cid                      Contact-Id (Format: Contact-Id:Person-Id;Contact-Id2:Person-Id2;...) 
string(255)             $name                     Contact-Name 
int                     $time                     Anruf-Zeit (Unix-Timestamp)
string(255)             $subject                  Betreff des Anrufs
binary                  $body                     Nachricht des Anrufs (Notizen)
string(255)             $userid                   Userids (Format: User-Id1:User-Id2)
int                     $pid                      Projekt-Id 
int                     $duration                 Anrufdauer in Sekunden
int                     $done                     0 für "Anruf erledigt", 1 für "Anruf nicht erledigt"  
int                     $io                       0 für eingehenden Anruf, 1 für ausgehenden Anruf 
string(128)             $lnumber                  Lokale Telefonnummer (Angerufener)
string(128)             $rnumber                  Entfernte Telefonnummer (Anrufer)
string(128)             $city                     Ort des Anrufers
double                  $costs                    Anrufkosten in der gegebenen Währung( $currency )
string(3)               $currency                 Währung der Anrufkosten
string(255)             $category                 Kategorien, Format: Category1; Category2; ... 
double                  $obligingness             Die Kulanz für den Anruf
int                     $rem                      Wiedervorlage (1: wenn an den Anruf erinnert werden soll, 0 wenn nicht)
int                     $remtime                  Unix-Timestamp für die Wiedervorlage

Beispiel:

<?php
 
include_once 'crm_rest_api.php';
 
try {
	/* @var $rest_api crmcti */
	$rest_api = new crm_rest_api("http://hostname/dirname/rest/index.php/cti");
 
	$call = array(
		'cid'       => 0,
		'userid'    => 1,
		'time'      => time(),
		'name'      => "",
		'subject'   => "Incoming Call",
		'body'      => "",
		'pid'       => 0,
		'lnumber'   => "036155656",
		'rnumber'   => "766333134",
		'city'      => "Erfurt",
		'costs'     => 12.77,
		'currency'  => "EUR",
		'category'  => "",
		'io'        => 0
	);
 
	$call_id = $rest_api->crmaddCall(array('crmCallItem' => $call));
 
	echo $call_id;
}
catch (Exception $e) {
	print $e->getMessage();
}



3.2. crmendCall

Syntax:

int crmendCall( string $session_id, int $call_id )

Beschreibung:

Beendet einen Anruf und setzt die Anrufdauer.

Gibt die übergebene call_id zurück und wirft eine Exception im Fehlerfall.

Beispiel:

<?php
   
try {
	$result_call_id = $rest_api->crmendCall(array('call_id' => $call_id));  
}
     
catch (Exception $e) {
	echo $e->getMessage(); 
}
         
echo $result_call_id;
       



3.3. crmgetPhoneList

Syntax:

array crmgetPhoneList( string $session_id )

Beschreibung:

Gibt eine Liste aller eingerichteten Telefone mit Zugangsdaten und Nebenstellen zurück.

Zurückgegeben wird ein Array von Objekten mit folgenden Eigenschaften:

Type(Length) Eigenschaft Beschreibung


int userid Id des TecArt-System Benutzers string(255) user Benutzername des Nutzers an der Telefonanlage string(255) pass Passwort des Nutzers an der Telefonanlage string(255) phone Telefon-ID string(255) extension Nebenstelle(n) kommagetrennt string(255) scheme URL-Schema (http oder https) string(255) shost URL-Host string(255) path URL-Path string(255) host URL der Telefonanlage

Beispiel:

<?php
 
try {
	$result = $rest_api->crmgetPhoneList($session_id);
 
	foreach ($result as $phone) {
 
		echo $phone->userid."<br>";
		echo $phone->user."<br>";
		echo $phone->pass."<br>";
		echo $phone->phone."<br>";
		echo $phone->extension."<br>";
		echo $phone->scheme."<br>";
		echo $phone->shost."<br>";
		echo $phone->path."<br>";
		echo $phone->host."<br>"; 
	}
}
catch (Exception $e) {
	echo $e->getMessage();
}
  • No labels