Protocolo CTI uTech/CMD PHONEBOOK

O PHONEBOOK é um comando enviado pela Aplicação CTI ao Servidor para buscar contatos da agenda corporativa. Com esse comando é possível procurar um contato por nome e numero, ou montar uma agenda paginada. No comando há dois parâmetros (NAME e NUMBER) que podem ser utilizados para filtrar os contatos da agenda corporativa.

Parâmetros

Parâmetros enviados para o Servidor
NAME	Nome ou sequencia de caracteres a procurar.
NUMBER	Numero ou sequencia de números a procurar.
LIMIT	Tamanho máximo da lista retornada.
OFFSET	Paginação da agenda. Ex. 1, 2, 3.

Comando

PHONEBOOK NAME:jeferson NUMBER: LIMIT:10 OFFSET:0\r\n\r\n

Fluxo

APP CTI > SERVIDOR CTI
PHONEBOOK NAME:jeferson NUMBER: LIMIT:10 OFFSET:0\r\n\r\n
SERVIDOR CTI > APP CTI
PHONEBOOK CONTACTS:"Jeferson Andre Cassol,0,84079082;" RESP:OK\r\n\r\n	Comando aceito pelo PABX
PHONEBOOK RESP:ERROR\r\n\r\n	Erro reportado pelo PABX

NOTA: Quando a resposta do servidor for um OK, o servidor enviará o parâmetro CONTACTS contendo uma lista de contatos entre aspas duplas.

Formato dos Contatos da Agenda

A lista de contatos retornado pelo Servidor é separado pelo caractere ; (ponto e virgula). Ex:

Contato 1 ; Contato 2 ; Contato 3

Já os dados de cada contato, são separados pelo caractere , virgula. Ex:

Identificação do Contato, Tipo do Contato, Numero

João,3,2001

Parâmetros do Contato

Parâmetros do Contato
Identificação	Identificação do contatos.
Tipo	Tipo do contato: 0: Móvel/Celular 1: Comercial 2: Residencial 3: Ramal
Numero	Numero do contato.

Exemplo PHP

<?php function get_phonebook($socket, $name, $num, $limit, $offset) { $data = "PHONEBOOK NAME:$name NUMBER:$num LIMIT:$limit OFFSET:$offset\r\n\r\n"; socket_write($socket, $data, strlen($data)); if(!$rd) return 1;   return 0; }?>

---

Volta ao menu