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

Bitte beachten Sie, dass seit TecArt Version 4.10 und aufwärts der SOAP Webservice nicht mehr weiterentwickelt wird. Ab der TecArt Version 5.1 ist der SOAP Webservice nicht mehr unterstützt.

Please note: with the release of TecArt version 4.10 onwards SOAP Webservice will no longer be updated or expanded. With the release of TecArt version 5.1, the soap webservice will be deprecated.

Dieser Webservice kann mit dem TecArt-System ab Version 3.4 genutzt werden.

1. WSDL-URI

http://hostname/dirname/soap/index.php?op=cti&wsdl

z.B. https://test.tecart-system.de/soap/index.php?op=cti&wsdl

2. Methoden

2.1. crmaddCall

Syntax:

int crmaddCall( string $session_id, crmCallItem $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.

$crmCallItem ist entweder ein assoziatives Array oder ein Objekt

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
 
ini_set("soap.wsdl_cache_enabled", "0");
 
try {
  $client_logon = new SOAPClient("https://test.tecart-system.de/soap/index.php?op=logon&wsdl");
     $session_id = $client_logon->crmLogin('test', 'test');
     if (!$session_id) die("invalid login");
 
   $client_cti = new SOAPClient("https://test.tecart-system.de/soap/index.php?op=cti&wsdl");
 
   $call       = array( 'cid'       => 0,
                        'time'      => time(),
                        'name'      => "",
                        'userid'    => 1,
                        'subject'   => "Outgoing Call",
                        'body'      => "",
                        'pid'       => "",
                        'duration'  => 0,
                        'done'      => 0,
                        'lnumber'   => "036155656",
                        'rnumber'   => "766333134",
                        'city'      => "Erfurt",
                        'costs'     => 12.77,
                        'currency'  => "EUR",
                        'category'  => "",
                        'io'        => 1 );
 
    $call_id = $client_cti->crmaddCall($session_id, $call);
}
catch (Exception $e) {
  print $e->getMessage();
}

2.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 = $client_cti->crmendCall($session_id, $call_id);
}
catch (Exception $e) {
  echo $e->getMessage();
}
 
echo $call_id;

2.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 = $client_cti->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