Integração com CTI 3CX

A integração com CTI 3CX permite que usuários efetuem e recebam ligações de forma prática sem precisar sair da tela do Gestão de Relacionamento | CRM. Para utilizar a integração, é necessário utilizar uma extensão disponível apenas para os navegadores Google Chrome e Microsoft Edge. Com a extensão habilitada, o 3CX identificará os campos de telefone do Gestão de Relacionamento | CRM, onde será possível efetuar as ligações.

Com a extensão do navegador ativa, todas as ligações serão exibidas no pop-up da 3CX. Na integração está previsto a disponibilização de uma API para a 3CX consultar as contas e contatos diretamente do sistema, exibindo assim o nome do contato no momento da ligação. Todos os contatos feitos entre vendedor e cliente (visitas, ligações efetuadas e envio de e-mails) ficam registrados no Gestão de Relacionamento | CRM, na guia Colaborativo.

Importante

O formato da máscara do cadastro do telefone e/ou celular vai depender da configuração realizada no 3CX, porém por padrão é necessário adicionar 00 + DDD + Número. O Gestão de Relacionamento | CRM não faz esse tratamento no produto, por isso, o mesmo deve ser feito no momento da carga inicial ou via integração. Quando cadastrado manualmente, o usuário deve verificar se o formato está correto, caso contrário as ligações não serão completadas e será necessário atualizar o número manualmente.

O Gestão de Relacionamento | CRM possui duas APIs para integração com o CTI 3CX: consult-phone e end-call. Segue abaixo, um breve descritivo de como consumir tais recursos:

consult-phone

Método: GET
Header:
- token_crm: string de token crm (o token para acessar essa API deve ser solicitado a equipe do Gestão de Relacionamento | CRM)
- Content-Type: application/json
- tenant: nomedotenant
URL: api.crmsenior.com.br/cti3cx/consult-phone/<<(int)TELEFONE>>

Retorno:

{"error": "<<error message>>"}

{
    "contact": [
        {
            "id": "<<ID>>",              
            "firstname": "<<firstname>>",
            "lastname": "<<lastname>>",
            "company": "<<company>>",
            "email": "<<email>>",
            "businessphone": "<<businessphone>>",
            "businessphone2": "<<businessphone2>>",
            "mobilephone": "<<mobilephone>>",
            "mobilephone2": "<<mobilephone2>>",
            "url": "",
            "customvalue": "<<client/contact/call_id>>"
        }
    ]
}

end-call

Método: PUT
Header:
- token_crm: string de token crm (o token para acessar essa API deve ser solicitado a equipe do Gestão de Relacionamento | CRM)
- Content-Type: application/json
- tenant: nomedotenant
URL: api.crmsenior.com.br/cti3cx/end-call/<<(int)ID (customvalue->call_id)>>
Body: { “data”: “DATA_LIGACAO”, “hora_inicio”: “HORA_INICIO_LIGACAO”, “hora_fim”: “HORA_FIM_LIGACAO”, “telefone”: “TELEFONE”, “calltype”: “TIPO_LIGACAO”, “agent”: “RAMAL” }

Retorno:

{"error": "<<error message>>"}

{
    {"success": "<<success message>>"}
}

Ao realizar a requisição para o consult-phone, será gerada uma ligação no Gestão de Relacionamento | CRM e o ID, que será retornado no customvalue->call_id, deverá ser utilizado no serviço de end-call.

Para fazer o download da collection e realizar validações no Postman, clique aqui.