Gestão de Chamadas
Inicie chamadas a partir do seu software (click-to-call), termine, transfira ou silencie chamadas em curso. Todos os endpoints utilizam a chave de API (âmbito call; Authorization: Bearer bt_… no cabeçalho, ver Segurança da API) com e GET é chamado com o método.
Limite de pedidos: 10 por minuto. Identificador da chamada (call_uuid)begin_callé devolvido na resposta e nos dados de chamadas em direto.
GETIniciar chamada (click-to-call)
Toca primeiro a extensão indicada; quando a extensão atende, o número de destino é chamado e os dois lados são ligados.
GET https://api.buluthat.com/api/begin_call.php?extension=1001&destination=905321234567| Parâmetro | Obrigatório | Descrição |
|---|---|---|
Authorization (cabeçalho) | sim | Bearer bt_…, âmbito call |
extension | sim | Extensão à qual a chamada é ligada (p. ex. 1001) |
destination | sim | Número a chamar. Para a Turquia 905321234567, para o estrangeiro 00 + indicativo do país |
caller_id | não | Número a apresentar nas chamadas externas; se não for indicado, o predefinido da extensão. Número que não pertence à sua conta 400 devolve |
manual_answer | não | true se for, espera-se que a extensão atenda manualmente; se não for indicado, nos dispositivos compatíveis é atendida automaticamente |
timeout | não | Tempo de toque, 10-60 s (por defeito 30) |
announcement_to_caller | não | ID do anúncio a reproduzir à extensão no momento da ligação |
announcement_to_callee | não | ID do anúncio a reproduzir ao chamado no momento da ligação |
Resposta de sucesso: 200 OK, no corpo o identificador da chamada.
358c20bc-fd86-11e5-87a2-157d41a07454Exemplos de respostas com erro:
400 Bad Request extension 1005 not found
400 Bad Request caller_id 02120000000 not allowed
401 Unauthorized Geçersiz anahtar: K…GETTerminar a chamada
GET https://api.buluthat.com/api/hangup.php?id=<call_uuid>id em vez de, também é aceite o formato de caminho: /api/hangup/<call_uuid>. Resposta 200 OK.
GETTransferir a chamada
Transfere a chamada em curso para uma extensão ou número externo.
GET https://api.buluthat.com/api/transfer.php?id=<call_uuid>&user_number=1002| Parâmetro | Descrição |
|---|---|
id | Identificador da chamada |
user_number | Extensão de destino (p. ex. 1002) ou número externo (905321234567) |
GETSilenciar / ativar o som
GET https://api.buluthat.com/api/mute.php?id=<call_uuid>&state=onstate: on (silenciar) ou off (ativar o som).
Dados de chamadas em direto
A lista de chamadas em curso (origem, destino, extensão, estado, duração) lê-se no endpoint da ponte de CRM; para abrir a ficha do cliente na chamada recebida, utilize estes dados ou os webhooks. Para detalhes, peça no Centro de Apoio a documentação "Ponte de CRM"; a ponte está pronta para o Byfix CRM.
Fluxo típico: click-to-call a partir do CRM
1. Kullanıcı CRM'de numaraya tıklar
2. Sunucunuz begin_call'u çağırır (extension = kullanıcının dahilisi)
3. Dahili çalar, açınca müşteri aranır; call_uuid'yi kaydedin
4. Görüşme bitince CDR raporda; kayıt panelden dinlenir