Base de conhecimento

Envio de Metadados de Ligações VoIP/SIP
3 min
Criado por: Ana Bittencourt em: 24/03/2020 12:02

Para enviar metadados de ligações para o CRM PipeRun, a operadora deverá ter a intenção de se homologar, se tornando assim um parceiro da plataforma. Ele deverá enviar um e-mail para o setor de vendas, informando essa intenção. O e-mail para este contato é sales@pipe.run.

 

No título do e-mail, informe: Homologar empresa de Telefonia com o CRM PipeRun

Envie os dados de sua empresa operadora de telefonia.

Identifique o cliente usuário do PipeRun que o indicou.

Informe os responsáveis comerciais e técnicos de sua empresa.

 

Quando a parceria for fechada, seu serviço será homologado e receberá um token secreto para enviar metadados para a API do PipeRun e preencher as informações de uma chamada já cadastrada em nosso banco de dados. O token poderá ser fornecido por e-mail ou então você receberá as instruções para contactar o suporte para o recebimento dele.

 

Os metadados são enviados para um webhook, criado especialmente para o seu serviço, por meio de uma requisição HTTP com método POST. Este webhook estará disponível em: https://api.pipe.run/v1/webhooks/webphones/[token-secreto]

 

A requisição deve ter o header Content-Type: application/json.

A estrutura do corpo da requisição deve ser a seguinte, em JSON:

atributo descrição
id id da ligação (integer)
start_at datetime inicial da ligação (string Y-m-d H:i:s)
end_at datetime final da ligação (string Y-m-d H:i:s)
status 200 para OK ou 404 para erro (integer)
record_url URL para arquivo de áudio da ligação em mp3 (string)
external_call_id id da ligação no banco do parceiro (integer - optional)
duration duração da ligação (string H:i:s)
cost custo em reais da ligação (float)

 

NOTA: O id da ligação é enviado ao seu serviço quando a chamada é agendada. Por ele, vinculamos a chamada à oportunidade de onde a chamada foi originada.

Abaixo há um exemplo de requisição de envio de metadados:

 

A seguir, confira um exemplo de retorno esperado desta requisição:

 

Em caso de dúvida, entre em contato com nossa equipe de suporte

Este artigo foi útil para você?
Últimos artigos visitados