Cada chamada de voz recebe um estado no diário em Diário -> Voz. Na vista de detalhe de uma chamada vê ainda o Resultado técnico (hangup cause) e, em Terminada por, qual das partes terminou a ligação. Os mesmos valores são devolvidos pela API e pelo webhook voice_status.
Estado temporário
Estes estados ainda mudam enquanto a chamada está a decorrer.
| Estado no diário | Valor API | Significado |
|---|---|---|
| Iniciada | initiated |
A chamada foi aceite e está a ser estabelecida |
| A tocar | ringing |
A linha do destinatário está a tocar |
| Ativa | in-progress |
O destinatário atendeu, a mensagem está a ser reproduzida |
Estado final
Estes estados já não mudam. Apenas o estado Concluída é cobrado.
| Estado no diário | Valor API | Resultado (hangup cause) | Significado | Faturação |
|---|---|---|---|---|
| Concluída | completed |
NORMAL_CLEARING |
O destinatário atendeu a chamada e a ligação terminou normalmente | ✅ |
| Rejeitada | rejected |
CALL_REJECTED |
A chamada foi ativamente recusada na linha do destinatário | ❌ |
| Ocupado | busy |
USER_BUSY |
A linha do destinatário está ocupada | ❌ |
| Sem resposta | no-answer |
NO_ANSWER, NO_USER_RESPONSE |
A chamada não foi atendida dentro do tempo de toque | ❌ |
| Falhou | failed |
p. ex. UNALLOCATED_NUMBER, NO_ROUTE_DESTINATION, NETWORK_OUT_OF_ORDER |
A chamada não pôde ser estabelecida, por exemplo porque o número não está atribuído ou a rede de destino estava inacessível | ❌ |
A duração é contada a partir do momento em que o destinatário atende. O tempo de toque não é cobrado. Os preços por minuto para cada país de destino encontram-se na nossa página de preços.
O que significa "Rejeitada"?
O estado Rejeitada com o resultado CALL_REJECTED significa que a chamada foi estabelecida corretamente e chegou ao destinatário, mas foi aí ativamente recusada. Neste caso, a causa está no dispositivo ou na linha do destinatário e não na seven. Motivos habituais:
- O número do remetente está na lista de bloqueio do telefone.
- Está ativo um perfil "Não incomodar" ou os números desconhecidos estão silenciados.
- O operador móvel do destinatário filtra a chamada como spam ou chamada publicitária.
- O destinatário recusou a chamada manualmente.
Um número inválido ou não atribuído aparece, pelo contrário, como Falhou e não como Rejeitada. Se o mesmo remetente chega normalmente a outros destinatários, peça ao destinatário afetado que verifique as definições referidas e faça depois uma nova chamada de teste.
Quem desligou?
O campo Terminada por na vista de detalhe mostra qual das partes terminou a ligação:
| Valor | Significado |
|---|---|
| Autor da chamada | A seven desligou, por exemplo no fim da mensagem |
| Destinatário da chamada | O destinatário desligou |
| Rejeitada | A linha do destinatário recusou a chamada |
| Abortada | A chamada foi cancelada antes de ser atendida, por exemplo após expirar o tempo de toque |