documentação - intelbras

DocumentaçãoProtocolo CSTA para centrais Impacta

Protocolo CSTA para centrais Impacta Parabéns, você acaba de adquirir um produto com a qualidade e segurança Intelbras.

Este documento visa mostrar as particularidades da implementação do protocolo CSTA pela INTELBRAS nas centrais IMPACTA, comandos e eventos implementados, como tam-bém específicos, além de programações necessárias.

Índice1. ICTI 4

1.1. Conexão via ICTI com conexão com a Impacta via USB ou Serial . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4

1.2. Conexão via ICTI com conexão com a Impacta via Ethernet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5

1.3. Conexão via placa ICIP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5

2. Programação 5

2.1. Chave de registro . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5

2.2. Programação do CSTA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6

3. Compatibilidade 7

3.1. PABX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7

3.2. Versões . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7

4. Comunicação com o ICTI 7

4.1. Porta . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7

4.2. Formato do pacote de dados TCP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7

4.3. Autenticação . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7

5. Comandos e eventos CSTA 17

5.1. Comandos e Eventos CSTA implementados . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17

5.2. Comandos e Eventos CSTA passíveis de implementação . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .18

6. Comandos e eventos privados para Impacta 19

6.1. Comandos Escape . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19

6.2. Formato padrão CSTA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20

6.3. Solicitação de dados dos dispositivos do PABX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .22

6.4. Solicitação ou definição do turno . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .25

7. Protocolo CSTA 28

7.1. Normas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .28

7.2. Nome de dispositivos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .28

7.3. Restrições . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .30

7.4. Características de comandos CSTA da Impacta. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .30

7.5. Exemplos de cenários . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .35

4

1. ICTIO ICTI (Interface Computador Telefone Intelbras) deve estar instalado em um microcomputador e conectado a central IMPACTA via serial, USB ou ethernet. O cliente CSTA deve conectar-se neste ICTI.

Alternativamente pode-se utilizar a placa ICIP, neste caso não é necessária a instalação do ICTI e o cliente pode conectar-se diretamente em uma porta da desta placa.

1.1. Conexão via ICTI com conexão com a Impacta via USB ou Serial

5

1.2. Conexão via ICTI com conexão com a Impacta via Ethernet

1.3. Conexão via placa ICIP

2. Programação

2.1. Chave de registroÉ necessário o registro de uma licença para que seja possível utilizar o CSTA da Impacta.

Para este registro é necessária uma chave do produto CSTA e uma chave de confirmação. Para adquirir estas chaves, entre em contato com a Intelbras através do e-mail: [email protected]

6

O registro pode ser feito através do Programador Web, no menu Sistema/Licenças ou do ICTI Manager, no menu Registrar Produtos.

Ao solicitar as chaves, será necessário informar o número do Hardware do PABX existente na tela de registro. Cada licença é vinculada ao número do PABX.

Tela de programação de licenças

2.2. Programação do CSTAA central Impacta deve ser programada para operar com CSTA. Para isto abra o programador e habilite a opção CSTA/Mesa Virtual em Sistema/CSTA/Mesa Virtual. Reinicie a central após a programação.

Tela de programação do CSTA

7

3. Compatibilidade

3.1. PABXO serviço de CSTA está disponível para os PABXs da linha Impacta.

3.2. Versões1. Versão do PABX: 3.16.23 ou superior2. Versão do ICTI: 3.02.14 ou superior3. Versão da ICIP: 1.02.06 ou superior

4. Comunicação com o ICTI

4.1. PortaO cliente CSTA deve ser conectado à porta 7000 do servidor onde está instalado o ICTI ou à porta 7001 quando a placa ICIP for utilizada.

Esta conexão deve ser do tipo TCP/IP.

4.2. Formato do pacote de dados TCPApós o pacote de autenticação ou CSTA ser codificado, é necessário incluir um cabeçalho a este pacote.

Formato Cada pacote é enviado ou recebido no seguinte formato:

SS ss DD DD DD D..D DD DD

SS ss : Tamanho dos dados enviados ou recebidos, sendo SS o byte mais significativo e ss o byte menos significativo

DD.. : Dados CSTA ou ACSE.

Exemplo:

00 2C A1 2A 02 01 02 02 01 47 30 22 80 03 2A 31 33 30 18 80 03 02 00 01 81 02 00 00 82 02 02 01 83 02 06 0D 85 02 01 01 84 01 FF 0A 01 01

Tamanho : 0x002c = 44 bytes

Dados : A1 2A 02 01 02 02 01 47 30 22 80 03 2A 31 33 30 18 80 03 02 00 01 81 02 00 00 82 02 02 01 83 02 06 0D 85 02 01 01 84 01 FF 0A 01 01

4.3. AutenticaçãoPara que o cliente possa receber e enviar dados CSTA, é necessário o envio de uma mensagem de autenticação. A auten-ticação é feita utilizando o protocolo ACSE, onde são passados o id da aplicação, o usuário e a senha.

Formato ACSEUtiliza-se o padrão ACSE – 1 definido na norma X.227:04/1995.

Tipos de pacotes ACSE » AARQ : Solicitação de conexão. Enviado pelo cliente. » AARE : resposta do AARQ. Enviado pelo servidor » RLRQ : Solicitação de desconexão. Enviado pelo cliente » RLRE : Resposta de RLRQ. Enviado pelo servidor » ABRT: Finalização forçada da conexão. Enviado pelo servidor ou pelo cliente. Não necessita de resposta.

8

Norma ACSE- 1Transcrição direta da norma.

-- Module ACSE-1 (X.227:04/1995)

-- See also the index of all ASN.1 assignments needed in this document

ACSE-1 {joint-iso-itu-t association-control(2) modules(0) apdus(0) version1(1)}

-- ACSE-1 refers to ACSE version 1

DEFINITIONS ::=

BEGIN

EXPORTS

acse-as-id, ACSE-apdu, aCSE-id, Application-context-name, AP-title,

AE-qualifier, AE-title, AP-invocation-identifier, AE-invocation-identifier,

Mechanism-name, Authentication-value, ACSE-requirements, ObjectSet;

IMPORTS

Name, RelativeDistinguishedName

FROM InformationFramework {joint-iso-itu-t ds(5) module(1)

informationFramework(1) 3};

-- The data types Name and RelativeDistinguishedName are imported from ISO/IEC 9594-2.

-- object identifier assignments

acse-as-id OBJECT IDENTIFIER ::=

{joint-iso-itu-t association-control(2) abstract-syntax(1) apdus(0)

version1(1)}

-- may be used to reference the abstract syntax of the ACSE APDUs

aCSE-id OBJECT IDENTIFIER ::=

{joint-iso-itu-t association-control(2) ase-id(3) acse-ase(1) version(1)}

-- may be used to identify the Association Control ASE.

-- top level CHOICE

ACSE-apdu ::= CHOICE {

aarq AARQ-apdu,

aare AARE-apdu,

rlrq RLRQ-apdu,

rlre RLRE-apdu,

abrt ABRT-apdu,

...

}

9

AARQ-apdu ::= [APPLICATION 0] IMPLICIT SEQUENCE {

protocol-version

[0] IMPLICIT BIT STRING {version1(0)} DEFAULT {version1},

application-context-name [1] Application-context-name,

called-AP-title [2] AP-title OPTIONAL,

called-AE-qualifier [3] AE-qualifier OPTIONAL,

called-AP-invocation-identifier [4] AP-invocation-identifier OPTIONAL,

called-AE-invocation-identifier [5] AE-invocation-identifier OPTIONAL,

calling-AP-title [6] AP-title OPTIONAL,

calling-AE-qualifier [7] AE-qualifier OPTIONAL,

calling-AP-invocation-identifier [8] AP-invocation-identifier OPTIONAL,

calling-AE-invocation-identifier [9] AE-invocation-identifier OPTIONAL,

-- The following field shall not be present if only the Kernel is used.

sender-acse-requirements [10] IMPLICIT ACSE-requirements OPTIONAL,

-- The following field shall only be present if the Authentication functional unit is selected.

mechanism-name [11] IMPLICIT Mechanism-name OPTIONAL,


calling-authentication-value [12] EXPLICIT Authentication-value OPTIONAL,

application-context-name-list

[13] IMPLICIT Application-context-name-list OPTIONAL,

-- The above field shall only be present if the Application Context Negotiation functional unit is selected

implementation-information [29] IMPLICIT Implementation-data OPTIONAL,

...,

...,

user-information

[30] IMPLICIT Association-information OPTIONAL

}

AARE-apdu ::= [APPLICATION 1] IMPLICIT SEQUENCE {

protocol-version

[0] IMPLICIT BIT STRING {version1(0)} DEFAULT {version1},

application-context-name [1] Application-context-name,

result [2] Associate-result,

result-source-diagnostic [3] Associate-source-diagnostic,

responding-AP-title [4] AP-title OPTIONAL,

responding-AE-qualifier [5] AE-qualifier OPTIONAL,

responding-AP-invocation-identifier [6] AP-invocation-identifier OPTIONAL,

responding-AE-invocation-identifier [7] AE-invocation-identifier OPTIONAL,

-- The following field shall not be present if only the Kernel is used.

responder-acse-requirements [8] IMPLICIT ACSE-requirements OPTIONAL,


10

mechanism-name [9] IMPLICIT Mechanism-name OPTIONAL,

-- This following field shall only be present if the Authentication functional unit is selected.

responding-authentication-value

[10] EXPLICIT Authentication-value OPTIONAL,

application-context-name-list

[11] IMPLICIT Application-context-name-list OPTIONAL,

-- The above field shall only be present if the Application Context Negotiation functional unit is selected

implementation-information

[29] IMPLICIT Implementation-data OPTIONAL,

...,

...,

user-information

[30] IMPLICIT Association-information OPTIONAL

}

RLRQ-apdu ::= [APPLICATION 2] IMPLICIT SEQUENCE {

reason [0] IMPLICIT Release-request-reason OPTIONAL,

...,

...,

user-information [30] IMPLICIT Association-information OPTIONAL

}

RLRE-apdu ::= [APPLICATION 3] IMPLICIT SEQUENCE {

reason [0] IMPLICIT Release-response-reason OPTIONAL,

...,

...,


}

ABRT-apdu ::= [APPLICATION 4] IMPLICIT SEQUENCE {

abort-source [0] IMPLICIT ABRT-source,

abort-diagnostic [1] IMPLICIT ABRT-diagnostic OPTIONAL,

-- This field shall not be present if only the Kernel is used.

...,

...,


}

ABRT-diagnostic ::= ENUMERATED {

no-reason-given(1), protocol-error(2),

authentication-mechanism-name-not-recognized(3),

11

authentication-mechanism-name-required(4), authentication-failure(5),

authentication-required(6), ...

}

ABRT-source ::= INTEGER {acse-service-user(0), acse-service-provider(1)

}(0..1, ...)

ACSE-requirements ::= BIT STRING {

authentication(0), application-context-negotiation(1)}

Application-context-name-list ::= SEQUENCE OF Application-context-name

Application-context-name ::= OBJECT IDENTIFIER

-- Application-entity title productions follow (not in alphabetical order)

AP-title ::= CHOICE {

ap-title-form1 AP-title-form1,

ap-title-form2 AP-title-form2,

...

}

AE-qualifier ::= CHOICE {

ae-qualifier-form1 AE-qualifier-form1,

ae-qualifier-form2 AE-qualifier-form2,

...

}

-- When both AP-title and AE-qualifier data values are present in an AARQ or AARE APDU, both must

-- have the same form to allow the construction of an AE-title as discussed in CCITT Rec. X.665 |

-- ISO/IEC 9834-6.

AP-title-form1 ::=

Name

-- The value assigned to AP-title-form1 is The Directory Name of an application-process title.

AE-qualifier-form1 ::=

RelativeDistinguishedName

-- The value assigned to AE-qualifier-form1 is the relative distinguished name of a particular

-- application-entity of the application-process identified by AP-title-form1.

AP-title-form2 ::= OBJECT IDENTIFIER

12

AE-qualifier-form2 ::= INTEGER

AE-title ::= CHOICE {

ae-title-form1 AE-title-form1,

ae-title-form2 AE-title-form2,

...

}

-- As defined in CCITT Rec. X.650 | ISO 7498-3, an application-entity title is composed of an application-

-- process title and an application-entity qualifier. The ACSE protocol provides for the transfer of an

-- application-entity title value by the transfer of its component values. However, the following data type

-- is provided for International Standards that reference a single syntactic structure for AE titles.

AE-title-form1 ::=

Name

-- For access to The Directory (ITU-T Rec. X.500-Series | ISO/IEC 9594), an AE title has AE-title-form1.

-- This value can be constructed from AP-title-form1 and AE-qualifier-form1 values contained in an

-- AARQ or AARE APDU. A discussion of forming an AE-title-form1 from AP-title-form1 and AE-qualifier-

-- form1 may be found in CCITT Rec. X.665 | ISO/IEC 9834-6.

AE-title-form2 ::= OBJECT IDENTIFIER

-- A discussion of forming an AE-title-form2 from AP-title-form2 and AE-qualifier-form2 may be

-- found in CCITT Rec. X.665 | ISO/IEC 9834-6.

AE-invocation-identifier ::= INTEGER

AP-invocation-identifier ::= INTEGER

-- End of Application-entity title productions

Associate-result ::= INTEGER {

accepted(0), rejected-permanent(1), rejected-transient(2)}(0..2, ...)

Associate-source-diagnostic ::= CHOICE {

acse-service-user

[1] INTEGER {null(0), no-reason-given(1),

application-context-name-not-supported(2),

calling-AP-title-not-recognized(3),

calling-AP-invocation-identifier-not-recognized(4),

calling-AE-qualifier-not-recognized(5),

calling-AE-invocation-identifier-not-recognized(6),

called-AP-title-not-recognized(7),

called-AP-invocation-identifier-not-recognized(8),

called-AE-qualifier-not-recognized(9),

13

called-AE-invocation-identifier-not-recognized(10),

authentication-mechanism-name-not-recognized(11),

authentication-mechanism-name-required(12),

authentication-failure(13), authentication-required(14)}

(0..14, ...),

acse-service-provider

[2] INTEGER {null(0), no-reason-given(1), no-common-acse-version(2)}

(0..2, ...)

}

Association-information ::= SEQUENCE SIZE (1, ..., 0 | 2..MAX) OF EXTERNAL

Authentication-value ::= CHOICE {

charstring [0] IMPLICIT GraphicString,

bitstring [1] IMPLICIT BIT STRING,

external [2] IMPLICIT EXTERNAL,

other

[3] IMPLICIT SEQUENCE {other-mechanism-name

MECHANISM-NAME.&id({ObjectSet}),

other-mechanism-value

MECHANISM-NAME.&Type

({ObjectSet}{@.other-mechanism-name})}

}

-- The abstract syntax of (calling/responding) authentication-value is determined by the authentication

-- mechanism used during association establishment. The authentication mechanism is either explicitly

-- denoted by the &id field (of type OBJECT IDENTIFIER) for a mechanism belonging to the class

-- MECHANISM-NAME, or it is known implicitly by

-- prior agreement between the communicating partners. If the “other” component is chosen, then

-- the “mechanism-name” component must be present in accordance with

-- ITU-T Rec. X.680 | ISO/IEC 8824. If the value “mechanism-name” occurs in the AARQ-apdu or the

-- AARE-apdu, then that value must be the same as the value for “other-mechanism-name”

Implementation-data ::= GraphicString

Mechanism-name ::= OBJECT IDENTIFIER

MECHANISM-NAME ::= TYPE-IDENTIFIER

ObjectSet MECHANISM-NAME ::=

{...}

Release-request-reason ::= INTEGER {normal(0), urgent(1), user-defined(30)

14

}(0 | 1 | 30, ...)

Release-response-reason ::= INTEGER {

normal(0), not-finished(1), user-defined(30)}(0 | 1 | 30, ...)

END

Pacote AARQEste pacote contém as informações de autenticação e deve ser a primeira mensagem enviada pelo cliente ao servidor.

O cliente deverá aguardar a resposta AARE.

Formato do pacote AARQ

Campos Utilizados

protocol-version Fixo.

Definir o campo “version1” como true

application-context-name Fixo.

Definir como 1.3.12.0.218.200

sender-acse-requirementsFixo.

Definir os subcampos como:

» authentication = true » application-context-negotiation = false » calling-authentication-value

O campo deve ser preenchido com a estrutura Authentication-value.

Authentication-value ::= CHOICE

{

external [2] IMPLICIT PrivateExtData

}

PrivateExtData ::= [UNIVERSAL 8] IMPLICIT

15

{

encoding AsnData

}

AsnData ::= ANY

{

single-ASN1-type [0] External-authentication

}

External-authentication ::= SEQUENCE

{

AppId INTEGER,

UserName OCTECT STRING OPTIONAL

Password OCTECT STRING OPTIONAL

AdditionalData OCTECT STRING OPTIONAL

}

AppIdÉ o identificador da aplicação e deve possuir o valor 1 (um) sempre.

UserNameNome do usuário.

É uma string.

Exemplo: 200 ; pedro

PasswordSenha utilizada em conjunto com UserName.

É uma string.

Não está sendo utilizada e deve ter o valor de 1234 obrigatoriamente.

AdditionalDataNão utilizado.

Obs.: o usuário e senha não estão sendo validados, mas são utilizados para realizar “logs” da comunicação.

Formato do pacote60 S1 80 02 07 80 a1 09 06 07 2b 0c 00 81 5a 81 48 8a 02 06 80 ac 15 a2 13 a0 11 30 S2 02 01 01 04 S3 UU UU UU UU 04 04 31 32 33 34

UU : Usuário em ASCII

S3 : Número de bytes do usuário.

S2 : Número de bytes até o final do pacote = 11+ S3

S1 : Número de bytes até o final do pacote = 27 +S2

Exemplo de pacote(Não está incluso o header de tamanho do TCP)

UserName = 200. Em azul.

Password = 1234. Em verde.

60 29 80 02 07 80 a1 09 06 07 2b 0c 00 81 5a 8148 8a 02 06 80 ac 14 a2 12 a0 10 30 0e 02 01 01 04 03 32 30 30 04 04 31 32 33 34

UserName = 2000. Em azul.

16

Password = 1234. Em verde.

60 2a 80 02 07 80 a1 09 06 07 2b 0c 00 81 5a 81 48 8a 02 06 80 ac 15 a2 13 a0 11 30 0f 02 01 01 04 04 32 30 30 30 04 04 31 32 33 34

Pacote AAREEste pacote contém as informações de resposta ao pacote AARQ

Pacote AARE

Campos utilizados

protocol-version Sempre version1.

application-context-name Sempre com 1.3.12.0.218.200

result e result-source-diagnosticSe a conexão foi aceita, result contém accepted(0) e result-source-diagnostic contém null(0).

Se a conexão não foi aceita devido à senha/usuário inválidos ou porque não existem licenças, result contém rejected-per-manent(1) ou rejected-transient(2) e result-source-diagnostic contém no-reason-given(1) ou authentication-failure(13)

responding-AE-qualifierUtilizado para retornar a versão do ICTI. É um número inteiro que representa a versão. No exemplo a versão é 30216 , ou seja, 3.02.16.

Este valor está disponível apenas se o resultado da autenticação for positivo.

Formato do pacote61 2e 80 02 07 85 a1 09 06 07 2b 0c 00 81 5a 81 48 82 03 02 01 RR 83 05

81 03 02 01 RD 85 04 02 02 VV VV aa 0b a2 09 a0 07 30 05 02 03 00 ff ff

RR : resposta da conexão, pode ser 0, 1 ou 2 conforme descrito em result.

RD: complemento da resposta.

VV VV: versão do ICTI.

O restante do pacote não se altera.

17


61 2e 80 02 07 85 a1 09 06 07 2b 0c 00 81 5a 81 48 82 03 02 01 00 83 05

81 03 02 01 00 85 04 02 02 76 08 aa 0b a2 09 a0 07 30 05 02 03 00 ff ff

Pacote RLRQNão utilizado

Pacote RLRENão utilizado

Pacote ABRTEnviado para indicar uma desconexão antes de fechar a conexão TCP. É opcional para o cliente, não sendo necessário o envio antes da desconexão.


64 03 80 01 00

FuncionamentoO cliente CSTA deve enviar um pacote AARQ com o usuário preenchido e deve aguardar o retorno do pacote AARE. Deve--se, então, verificar a resposta da autenticação, caso seja accepted(0), pode-se iniciar o envio dos pacotes CSTA. Caso contrário, o pabx fechará a conexão TCP.

Caso o pacote AARQ não seja enviado e um pacote CSTA seja enviado, o pabx não analisa este pacote.

5. Comandos e eventos CSTA

5.1. Comandos e Eventos CSTA implementados Switching function services

» Alternate call » Answer call » Associate data » Clear connection » Conference call » Consultation call » Divert call » Hold call » Make call » Make predictive call » Park call » Query device » Reconnect call » Retrieve call » Send DTMF tones » Transfer call

Switching function events

Call events » Conferenced » Connection cleared » Delivered » Diverted

18

» Established » Failed » Held » Network reached » Originated » Queued » Retrieved » Service initiated » Transferred

Maintenance events » Back in service » Out of service

Private eventsPrivate.

Bidirectional services » Escape » System status

Status reporting services » Change monitor filter » Monitor start » Monitor stop » Snapshot call » Snapshot device

5.2. Comandos e Eventos CSTA passíveis de implementaçãoSwitching function services

» Call completion » Clear call » Set feature » Single step conference » Single step transfer

Switching function events

Call events » Call cleared

Agent events » Agent logged on » Agent logged off » Agent ready » Agent not ready » Agent working after call » Agent busy

Other feature events » Call information » Do not disturb » Forwarding » Message waiting » Auto answer » Microphone mute

19

» Speaker mute » Speaker volume

Voice unit events » Play » Record » Review » Stop » Suspend play » Suspend record » Voice attribute change

Computing function services » Route request » Reroute request » Route select request » Route used request » Route end request

Input/output services » Data path resumed » Data path suspended » Fast data » Resume data path » Send broadcast data » Send data » Send multicast data » Start data path » Stop data path » Suspend data path

Voice unit services » Concatenate message » Delete message » Play message » Query voice attribute » Record message » Reposition » Resume » Review » Set voice attribute » Stop » Suspend » Synthesize message

6. Comandos e eventos privados para Impacta

6.1. Comandos EscapeUtiliza a construção normal do CSTA para comando ESCAPE.

Ocorre a definição da propriedade CSTAPrivateData que é formado por um identificador único, que deve ser preenchido no envio do comando escape e está preenchido no recebimento do result do comando escape, e um dado específico da Intelbras.

20

Este dado depende do contexto e é utilizado para a solicitação e na resposta de um comando. Utiliza um padrão de cons-trução com tipos primitivos conforme o protocolo ASN.1.

6.2. Formato padrão CSTANotação utilizada conforme normas do CSTA.

Comando escapeescapeService OPERATION

ARGUMENT EscapeServiceArgument

RESULT EscapeServiceResult

ERRORS {universalFailure}

::= 51

EscapeServiceArgument ::=

SEQUENCE

{

security [0] IMPLICIT CSTASecurityData OPTIONAL,

privateData [1] IMPLICIT SEQUENCE OF CSTAPrivateData

}

EscapeServiceResult ::=

CHOICE

{

extensions CSTACommonArguments,

noData NULL

}

CommonArguments para o ResultCSTACommonArguments ::= [APPLICATION 30] IMPLICIT SEQUENCE

{

security [0] IMPLICIT CSTASecurityData OPTIONAL,

privateData [1] IMPLICIT SEQUENCE OF CSTAPrivateData OPTIONAL

}

Definição do private data

CSTAPrivateData ::= SEQUENCE

{

intelbrasId OBJECT IDENTIFIER,

intelbrasData [8] IntelbrasData

}

IntelbrasId := iso.3.6.1.4.1.26138 (1.3.6.1.4.1.26138) -- FIXO

IntelbrasData ::= CHOICE

{

21

setFeature [0] SetIntelbrasFeature ,

response [1] IntelbrasResponseData

}

SetIntelbrasFeature ::= CHOICE

{

ExistingDevices [0] IMPLICIT NULL ,

turno [1] Implicit INTEGER

}

IntelbrasResponseData ::= CHOICE

{

dadosDevice [0] IMPLICIT SEQUENCE OF DadosDeviceIntelbras,

turnoAtual [1] IMPLICIT INTEGER

}

DadosDeviceIntelbras ::= SEQUENCE

{

deviceType DeviceTypeIntelbras,

deviceName IA5String,

active BOOLEAN,

deviceId Integer

}

DeviceTypeIntelbras ::= ENUMERATED

{

Ramal (0),

TroncoAnalógico (1),

TroncoDigital (2),

Porteiro (3),

Correio (4),

Estacionamento (5),

TroncoVoip (6),

RamalDigital (7),

Grupo (8),

Modem (10),

RamalIp (11),

PedidoChamada ( 12),

JuntorGsm (13),

Disa (14),

GrupoCorreio (15),

BuscaPessoa (16),

22

Emergencia (17),

Generico (254),

}

6.3. Solicitação de dados dos dispositivos do PABXUtilizado para saber quais os ramais, troncos e outros dispositivos que estão disponíveis no pabx para serem utilizados.

Solicitação

Comando para retornar os dispositivos existentes

Deve ser executado o comando ESCAPE com a opção intelbrasData preenchida com o dado setFeature definida como ExistingDevices.

Exemplo do pacote Csta gerado:

A1 1C 02 01 02 02 01 33 30 14 A1 12 30 10 06 08 2B 06 01 04 01 81 CC 1A A8 04 A0 02 80 00

O pacote parcial A1 1C 02 01 02 02 01 33 30 14 A1 12 é padrão CSTA e o restante são os dados específicos da Intelbras.

30 10

06 08 2B 06 01 04 01 81 CC 1A Object identifier

A8 04 IntelbrasData

A0 02 SetFeatureIntelbras

80 00 ExistingDevices

O dado em verde é o valor para ExistingDevices.

23

Resposta

Resposta com os dispositivos existentes

Como resposta, é enviado no result do comando Escape, o dado IntelbrasResponseData com o dado dadosDevice. Este dado é composto de um conjunto de dados de cada dispositivo existente, contendo o nome do dispositivo, Ex.: 201, o tipo do dispositivo (DeviceTypeIntelbras), se o dispositivo está ou não ativo e um identificador interno.

Dispositivo ativo significa que o dispositivo está funcionando corretamente.

Dispositivo não ativo significa que o dispositivo foi definido como existente no pabx, mas não existe hardware para torná--lo funcional ou não está operando, como o caso de um ramal digital que está desconectado.


a2 82 04 90 02 01 01 30 82 04 89 02 01 33 7e 82 04 82 a1 82 04 7e 30 82 04 7a 06 08 2b 06 01 04

01 81 cc 1a a8 82 04 6c a1 82 04 68 a0 82 04 64 30 0f 0a 02 00 fe 16 03 23 36 39 01 01 ff 02 01

0d 30 10 0a 02 00 fe 16 03 23 38 37 01 01 ff 02 02 1f 6c 30 12 0a 02 00 fe 16 05 2a 31 39 30 30

01 01 ff 02 02 07 6c 30 12 0a 02 00 fe 16 05 2a 31 39 30 34 01 01 ff 02 02 07 70 30 12 0a 02 00

fe 16 05 2a 31 39 30 35 01 01 ff 02 02 07 71 30 11 0a 01 03 16 05 2a 31 39 30 36 01 01 ff 02 02

07 72 30 11 0a 01 04 16 05 2a 31 39 33 30 01 01 ff 02 02 07 8a 30 11 0a 01 04 16 05 2a 31 39 33

31 01 01 ff 02 02 07 8b 30 11 0a 01 04 16 05 2a 31 39 33 32 01 01 ff 02 02 07 8c 30 11 0a 01 04

16 05 2a 31 39 33 33 01 01 ff 02 02 07 8d 30 11 0a 01 04 16 05 2a 31 39 33 34 01 01 ff 02 02 07

8e 30 11 0a 01 04 16 05 2a 31 39 33 35 01 01 ff 02 02 07 8f 30 11 0a 01 04 16 05 2a 31 39 33 36

01 01 ff 02 02 07 90 30 11 0a 01 04 16 05 2a 31 39 33 37 01 01 ff 02 02 07 91 30 11 0a 01 06 16

05 2a 32 32 35 30 01 01 ff 02 02 08 ca 30 11 0a 01 06 16 05 2a 32 32 35 31 01 01 ff 02 02 08 cb

30 11 0a 01 06 16 05 2a 32 32 35 32 01 01 ff 02 02 08 cc 30 11 0a 01 06 16 05 2a 32 32 35 33 01

01 ff 02 02 08 cd 30 11 0a 01 06 16 05 2a 32 32 35 34 01 01 ff 02 02 08 ce 30 11 0a 01 06 16 05

2a 32 32 35 35 01 01 ff 02 02 08 cf 30 11 0a 01 06 16 05 2a 32 32 35 36 01 01 ff 02 02 08 d0 30

11 0a 01 06 16 05 2a 32 32 35 37 01 01 ff 02 02 08 d1 30 10 0a 01 05 16 05 2a 38 32 31 34 01 01

ff 02 01 0e 30 0f 0a 01 00 16 03 32 30 30 01 01 ff 02 02 03 e8 30 0f 0a 01 00 16 03 32 30 31 01

24

01 ff 02 02 03 e9 30 0f 0a 01 00 16 03 32 30 32 01 01 ff 02 02 03 ea 30 0f 0a 01 00 16 03 32 30

33 01 01 ff 02 02 03 eb 30 0f 0a 01 00 16 03 32 30 34 01 01 ff 02 02 03 ec 30 0f 0a 01 00 16 03

32 30 35 01 01 ff 02 02 03 ed 30 0f 0a 01 00 16 03 32 30 36 01 01 ff 02 02 03 ee 30 0f 0a 01 00

16 03 32 30 37 01 01 ff 02 02 03 ef 30 0f 0a 01 00 16 03 32 30 38 01 01 ff 02 02 03 f0 30 0f 0a

01 00 16 03 32 30 39 01 01 ff 02 02 03 f1 30 0f 0a 01 00 16 03 32 31 30 01 01 ff 02 02 03 f2 30

0f 0a 01 00 16 03 32 31 31 01 01 ff 02 02 03 f3 30 0f 0a 01 00 16 03 32 31 32 01 01 ff 02 02 03

f4 30 0f 0a 01 00 16 03 32 31 33 01 01 ff 02 02 03 f5 30 0f 0a 01 00 16 03 32 31 34 01 01 ff 02

02 03 f6 30 0f 0a 01 00 16 03 32 31 35 01 01 ff 02 02 03 f7 30 0f 0a 01 00 16 03 32 31 36 01 01

ff 02 02 03 f8 30 0f 0a 01 00 16 03 32 31 37 01 01 ff 02 02 03 f9 30 0f 0a 01 00 16 03 32 31 38

01 01 ff 02 02 03 fa 30 0f 0a 01 00 16 03 32 31 39 01 01 ff 02 02 03 fb 30 0f 0a 01 00 16 03 32

32 30 01 01 ff 02 02 03 fc 30 0f 0a 01 00 16 03 32 32 31 01 01 ff 02 02 03 fd 30 0f 0a 01 00 16

03 32 32 32 01 01 ff 02 02 03 fe 30 0f 0a 01 00 16 03 32 32 33 01 01 ff 02 02 03 ff 30 0f 0a 01

00 16 03 32 32 34 01 01 ff 02 02 04 00 30 0f 0a 01 00 16 03 32 32 35 01 01 ff 02 02 04 01 30 0f

0a 01 00 16 03 32 32 36 01 01 ff 02 02 04 02 30 0f 0a 01 00 16 03 32 32 37 01 01 ff 02 02 04 03

30 0f 0a 01 07 16 03 32 32 38 01 01 ff 02 02 04 04 30 0f 0a 01 07 16 03 32 32 39 01 01 ff 02 02

04 05 30 0f 0a 01 07 16 03 32 33 30 01 01 ff 02 02 04 06 30 0f 0a 01 07 16 03 32 33 31 01 01 ff

02 02 04 07 30 10 0a 01 01 16 04 38 39 30 31 01 01 ff 02 02 08 48 30 10 0a 01 01 16 04 38 39 30

32 01 01 ff 02 02 08 49 30 10 0a 01 01 16 04 38 39 30 33 01 01 ff 02 02 08 4a 30 10 0a 01 01 16

04 38 39 30 34 01 01 ff 02 02 08 4b 30 10 0a 01 01 16 04 38 39 30 35 01 01 ff 02 02 08 4c 30 10

0a 01 01 16 04 38 39 30 36 01 01 ff 02 02 08 4d 30 10 0a 01 01 16 04 38 39 30 37 01 01 ff 02 02

08 4e 30 10 0a 01 01 16 04 38 39 30 38 01 01 ff 02 02 08 4f

O dado em azul é padrão, podendo alterar os campos com tamanho.

O dado a2 82 04 90 02 01 01 30 82 04 89 02 01 33 7e 82 04 82 a1 82 04 7e é padrão CSTA e o restante é especifico da Intelbras.

30 82 04 7a indica que é uma sequencia de dados

06 08 2b 06 01 04 01 81 cc 1a Object identifier

a8 82 04 6c IntelbrasData

a1 82 04 68 IntelbrasResponseData

a0 82 04 64 ExistingDevices

Os dados que não estão em azul são referentes aos dispositivos existentes

30 0f Primeiro device

0a 02 00 fe deviceType

16 03 23 36 39 deviceName (Ex.:#69)

01 01 ff active

02 01 0d deviceId

........ O bloco anterior se repete para cada item da coleção de dispositivos

30 0f 0a 02 00 fe 16 03 23 36 39 01 01 ff 02 01 0d

30 10 0a 02 00 fe 16 03 23 38 37 01 01 ff 02 02 1f 6c

30 12 0a 02 00 fe 16 05 2a 31 39 30 30 01 01 ff 02 02 07 6c

........

25

........

30 10 0a 01 01 16 04 38 39 30 37 01 01 ff 02 02 08 4e

30 10 0a 01 01 16 04 38 39 30 38 01 01 ff 02 02 08 4f último device

Obs.: o tamanho de cada conjunto de dados é diferente pois possuem dados com tamanhos diferentes

6.4. Solicitação ou definição do turnoUtilizado para solicitar o estado do turno e para alterar o turno.

Solicitação/DefiniçãoEnviar o comando Escape com a opção intelbrasData preenchida com os dados setFeature e turno e como parâmetro do turno um número:

0- Para apenas solicitar sem alterar

1- Para definir o turno como diurno

2- Para definir o turno como noturno.


A1 1D 02 01 07 02 01 33 30 15 A1 13 30 11 06 08 2B 06 01 04 01 81 CC 1A A8 05 A0 03 81 01 XX

Onde XX é o parâmetro do turno (0,1 ou 2)

O pacote parcial A1 1D 02 01 07 02 01 33 30 15 A1 13 é padrão CSTA e o restante são os dados específicos da Intelbras.

30 11


A8 05 IntelbrasData

A0 03 SetFeatureIntelbras

81 01 01 turno (definindo o turno como diurno)

Solicitação do turno

26

Definição de turno diurno.

Definição de turno noturno

RespostaComo resposta, é enviado no result do comando Escape, o dado IntelbrasResponseData ,com o dado turno que foi passado.

Este dado contém:

1- Para definir o turno como diurno

2- Para definir o turno como noturno.

27

Exemplo do pacote CSTA gerado:

A2 1F 02 01 01 30 1A 02 01 33 7E 15 A1 13 30 11 06 08 2B 06 01 04 01 81 CC 1A A8 05 A1 03 A1 01 01

O pacote parcial A2 1F 02 01 01 30 1A 02 01 33 7E 15 A1 13 é padrão CSTA e o restante são os dados específicos da Intelbras.

30 11


A8 05 IntelbrasData

A1 03 IntelbrasResponseData

81 01 01 turnoAtual com o valor diurno

Resposta para turno diurno

Resposta para turno noturno

28

7. Protocolo CSTA

7.1. NormasO serviço de CSTA procura seguir as seguintes normas para CSTA fase 2:

» Ecma-217 » Ecma-218 » Tr-068

Elas podem ser baixadas nos sites:

http://www.ecma-international.org/publications/standards/Ecma-217.htm

http://www.ecma-international.org/publications/standards/Ecma-218.htm

http://www.ecma-international.org/publications/techreports/E-TR-068.htm

7.2. Nome de dispositivosO nome dos dispositivos utilizados pelos comandos e eventos do CSTA é o próprio número do ramal, por exemplo, 200. Estes nomes variam conforme a programação do PABX.

Alguns nomes podem conter # e * quando estes dispositivos são algum serviço interno do PABX.

Descrição dos dispositivos utilizados pelo CSTA da linha Impacta

Identificador Descrição #69 Disa #87 Grupo do correio *1902 Busca pessoa *1905 Modem *1930 Correio *1931 Correio *1932 Correio *1933 Correio *1934 Correio *1935 Correio *1936 Correio *1937 Correio *22 Pedido de chamada *8214 Estacionamento 61 Grupo 62 Grupo 63 Grupo 64 Grupo 65 Grupo 66 Grupo 67 Grupo 68 Grupo 691 Grupo 692 Grupo 8901 Juntor Analógico 8902 Juntor Analógico 8903 Juntor Analógico 8904 Juntor Analógico 8905 Juntor Analógico 8906 Juntor Analógico 8907 Juntor Analógico 8908 Juntor Analógico 89100 Juntor voip 8931 Juntor E1

29

8932 Juntor E1 8933 Juntor E1 8934 Juntor E1 8935 Juntor E1 8936 Juntor E1 8937 Juntor E1 8938 Juntor E1 8939 Juntor E1 8940 Juntor E1 8941 Juntor E1 8942 Juntor E1 8943 Juntor E1 8944 Juntor E1 8945 Juntor E1 8946 Juntor E1 8947 Juntor E1 8948 Juntor E1 8949 Juntor E1 8950 Juntor E1 8951 Juntor E1 8952 Juntor E1 8953 Juntor E1 8954 Juntor E1 8955 Juntor E1 8956 Juntor E1 8957 Juntor E1 8958 Juntor E1 8959 Juntor E1 8960 Juntor E1 8961 Juntor E1 8962 Juntor E1 8963 Juntor E1 8964 Juntor E1 8965 Juntor E1 8966 Juntor E1 8967 Juntor E1 8968 Juntor E1 8969 Juntor E1 8970 Juntor E1 8971 Juntor E1 8972 Juntor E1 8973 Juntor E1 8974 Juntor E1 8975 Juntor E1 8976 Juntor E1 8977 Juntor E1 8978 Juntor E1 8979 Juntor E1 8980 Juntor E1 8981 Juntor E1 8982 Juntor E1 8983 Juntor E1 8984 Juntor E1 8985 Juntor E1 8986 Juntor E1 8987 Juntor E1

30

8988 Juntor E1 8989 Juntor E1 8990 Juntor E1 8991 Juntor voip 8992 Juntor voip 8993 Juntor voip 8994 Juntor voip 8995 Juntor voip 8996 Juntor voip 8997 Juntor voip 8998 Juntor voip 8999 Juntor voip

* Depende da programação do PABX. Utilize o comando Escape para listar todos os dispositivos existentes.

7.3. RestriçõesComandosAlguns comandos CSTA, listados anteriormente, somente podem ser utilizados com ramais analógicos. Os comandos que causam uma ação no ramal, como desligar, atender, transferir, discar, somente funcionam em ramais analógicos. Caso o comando seja executado para um dispositivo não permitido, ocorre um erro como resposta ao comando, conforme norma CSTA.

O comando makepredictivecall funciona para todos os ramais.

O comando Divert, com função de desvio, funciona para todos os ramais.

EventosOs eventos CSTA estão disponíveis para todos os dispositivos do PABX.

Operação do ramal analógicoO ramal analógico opera sem a necessidade de se colocar no gancho após o término da ligação. Pode-se tirar o telefone do gancho e mantê-lo assim permanentemente. Para desligar, basta enviar um comando connectionclear; para atender deve-se enviar um comando answer call; para fazer uma ligação deve-se enviar um comando makecall; para discar algum número utilize o comando sendDtmf.

Se o telefone estiver fora do gancho, ao receber uma ligação, não ocorre o ring do telefone, mas o usuário receberá um sinal sonoro diferenciado indicando que existe uma ligação. Se estiver no gancho, o ring será gerado, mas para após o envio do comando answerCall.

7.4. Características de comandos CSTA da Impacta.Makecall

Possibilidades » Pode-se utilizar o comando makecall para tirar um ramal do gancho, para isto basta definir o CalledDirectoryNumber

com vazio » Pode-se tirar do gancho com o makecall e discar via teclado do telefone » Pode-se executar um makecall com um número parcial e discar o restante pelo teclado. » Para discar um tronco é necessário incluir a rota de acesso ao tronco, por exemplo, 030300000 ( neste caso 0 é a rota).

O pabx permite várias programações que podem evitar a utilização da rota, e da operadora no caso de ligações DDD. » É possível definir um correlatorData, um campo texto de até 128 caracteres » É possível definir um código de conta (Account Code) e a sua senha (Authentication Code) através dos parâmetros do

comando.

Exemplos de comandos makecallTirando do gancho

31

Comando para tirar do gancho

Discagem do ramal 200 para o ramal 201

Comando

32

Resposta

Discagem com correlator data

Comando

Discagem com Código de Conta

Código de conta = 10000 e senha = 1234

33

Comando

AnswerCall

Possibilidades » Pode-se enviar apenas o ramal caso desejar atender a ligação que está recebendo. A call é opcional » Pode-se atender uma ligação que está na fila, com isto a ligação que está chegando passa para a fila. Neste caso é

necessário definir a call da ligação da fila e o ramal que deve atender.

Exemplos do comando AnswerCall

Definição apenas do ramal

34

Definição do ramal e identificador da ligação

ClearConnection

Possibilidades » Pode-se enviar apenas o ramal. A “call” é opcional.

Exemplo de comando ClearConnection

SendDtmf

PossibilidadesEste comando pode ser utilizado para enviar dígitos dtmf após uma ligação ter sido completada. Isto é útil para se enviar dígitos para URA (unidade remota de atendimento), por exemplo: bancos.

35

Caso se utilize o comando makecall para se tirar do gancho ou manualmente retirar o telefone do gancho, pode-se digitar os número individualmente ou em grupo através do comando SendDtmf.

A identificação da ligação é opcional.

Discagem após Makecall tirar do gancho:

7.5. Exemplos de cenáriosNo site da Intelbras, na área de Suporte e Downloads das centrais Impacta, está disponível em formato HTML o documento Protocolo CSTA - Exemplos de Cenários. Este documento contém diversos cenários de ligações e seus comandos e eventos CSTA, o mesmo foi escrito em um formato parecido com a norma TR-068.

Nos cenários apresentados, troncos analógicos estão conectados a ramais do próprio PABX, alguns troncos possuem identificação de chamada enquanto outros não possuem. O PABX possui dois links E1, sendo conectados entre si, assim uma ligação que sai pelo link 1 do PABX entra pelo link 2 do próprio PABX. Para o link 1 foi utilizada a rota 83 e para o link 2 a rota 84.

Suporte a clientes: (48) 2106 0006Fórum: forum.intelbras.com.brSuporte via chat: intelbras.com.br/suporte-tecnicoSuporte via e-mail: [email protected]: 0800 7042767Onde comprar? Quem instala?: 0800 7245115Produzido por: Intelbras S/A – Indústria de Telecomunicação Eletrônica BrasileiraRodovia SC 281, km 4,5 – Sertão do Maruim – São José/SC – 88122-001CNPJ 82.901.000/0014-41 – www.intelbras.com.br

02.19Indústria brasileira

documentação - intelbras

Documents