Skip to main content
Este guia explica como incorporar a interface do CloudTalk Phone na sua própria aplicação web através de um iframe.
Nível de utilizador:
  • Admin

​
Instalar o iFrame

​
Inicialização

Para incorporar e inicializar o CloudTalk Phone: Exemplo:

​
Requisitos

  • Dimensões mínimas: 700px de altura × 420px de largura
  • O CloudTalk Phone tem de ser incorporado numa Single Page Application (SPA). Não deve ser recarregado ao navegar entre vistas dentro da sua aplicação.
As notificações não são suportadas na versão incorporada. Em alguns casos, os utilizadores podem ver um aviso como “As notificações não estão ativadas” - trata-se de um problema visual conhecido que não afeta o funcionamento.

​
Escutar eventos

Pode registar-se nos eventos do CloudTalk Phone através de window.onmessage. Isto permite que o seu sistema reaja a eventos como chamadas recebidas ou o fim de chamadas (por exemplo, mostrando um painel com os detalhes do contacto ou colocando o telefone em primeiro plano). O CloudTalk Phone incorporado comunica com a aplicação principal através de window.postMessage. Pode escutar com window.onmessage ou window.addEventListener("message", ...).

​
Eventos suportados

  • ringing – acionado quando surge uma notificação de chamada recebida (a chamada começa a tocar no telefone incorporado)
  • dialing – acionado quando um utilizador inicia uma chamada de saída (clica em marcar)
  • calling – acionado quando a chamada é atendida (a outra parte atende)
  • hangup – acionado quando o utilizador clica no botão vermelho de terminar chamada (ação do utilizador)
  • ended – acionado quando a sessão da chamada é totalmente terminada
  • contact_info – acionado quando os dados do contacto relacionados com a chamada estão disponíveis ou são atualizados

​
Comportamento importante dos eventos

Se um utilizador terminar manualmente uma chamada:
  • hangup é acionado primeiro (ação do utilizador)
  • ended é acionado depois (encerramento da sessão)
No entanto, ended também pode ser acionado sem um hangup anterior (por exemplo, quando a chamada é rejeitada, falha ou termina devido a um erro). Utilização recomendada:
  • Escute hangup se precisar de reagir especificamente ao facto de um utilizador terminar manualmente uma chamada.
  • Escute ended se precisar de detetar que a chamada está totalmente concluída, independentemente de como terminou.
Pode querer maximizar uma janela do telefone minimizada quando existe uma chamada recebida ou abrir automaticamente a página de detalhes do contacto de quem liga no seu sistema. Exemplo:

​
Exemplo de payload

Todos os eventos seguem esta mesma estrutura: event + properties com call_uuid, external_number, internal_number e contact (se disponível).
Precisa de ajuda ou tem alguma questão? Contacte-nos através do nosso Portal de suporte— estamos aqui para si.