Pular para o conteúdo principal

O que ainda não existe

Esta página existe para não haver expectativa errada. Ela é atualizada quando algo sai.

Transcrição de ligação inteira​

Status: não disponível.

A plataforma transcreve mensagens de áudio (o áudio que o cliente manda no WhatsApp), mas não a gravação completa de uma ligação. A diferença é quem fala: numa mensagem de voz, o falante é o interlocutor da própria mensagem; numa ligação, os dois lados estão no mesmo arquivo, e separá-los exige diarização, que está em desenvolvimento.

O que acontece se você enviar só a URL: a ingestão responde 201 com status: "Transcrição pendente", e a interação vai para Falha no processamento, com o motivo escrito na tela.

O que fazer até então: enviar mensagens com a transcrição do seu lado. Ver Enviar uma ligação.

Se o seu discador não transcreve: converse com o time do QA Analytics antes de integrar o canal de voz. O canal de texto funciona por inteiro e não depende disso.

Retorno para o parceiro​

Status: não existe, e não está previsto.

A plataforma não chama nenhum webhook de volta com nota, resumo, status ou alerta de não conformidade. Não há callback, não há fila de saída, não há assinatura de eventos.

O resultado da auditoria vive na tela do cliente e nos relatórios dele.

Se a sua operação precisa reagir ao resultado — abrir um caso, notificar um supervisor no seu sistema — isso é conversa comercial, não configuração. Fale com o time.

Consulta de interação pela chave de ingestão​

Status: não existe.

A chave de ingestão só escreve. Não há endpoint para consultar o estado de uma interação usando X-Api-Key.

Os endpoints de leitura existem, mas exigem login de usuário (JWT) e pertencem à tela do cliente. Se você precisa saber se uma interação chegou, a resposta da ingestão já diz: guarde o interacaoId e o resultado. Ver A resposta.

Rate limit publicado​

Status: não há teto formal documentado.

Não existe limite de requisições por segundo publicado, e não há header de rate limit na resposta.

Isso não é permissão para disparar sem controle. Trate a API com bom senso: lotes com concorrência moderada, e 5xx como sinal de recuar. Um limite formal pode aparecer — quando aparecer, ele vem documentado e com aviso, não de surpresa.

Reabrir conversa concluída​

Status: não existe, e é por desenho.

Conversa enviada com parcial: false é imutável. Se a origem marcou errado e o atendimento continuou, o conteúdo novo não entra — reenviar devolve 200 Duplicada.

O motivo está em Conversa que continuou: a auditoria foi feita sobre um material, e mudá-lo depois transformaria a nota registrada em resposta a uma pergunta que ninguém mais consegue ler.

Corrigir metadado de interação já enviada​

Status: não pela API.

Metadados não entram na comparação de idempotência, então reenviar a conversa com metadados corrigidos devolve Duplicada e não atualiza nada. O cliente pode ajustar na curadoria dele.

Ver Metadados.

Ambiente de sandbox com dados fictícios​

Status: não existe como produto.

Há ambiente de homologação, com chave própria, mas ele é uma instância vazia — não vem populado com conversas de exemplo. Os testes do checklist de go-live usam conversas que você mesmo envia.


E o que existe e talvez você não saiba​

Do outro lado da lista, três coisas que a integração já entrega e que costumam passar batido:

  • Reenvio é seguro sempre. Retry não duplica e não cobra. Ver Idempotência.
  • Conversa incompleta é auditável. parcial: true não adia nada — a conversa é analisada como está, e pode ser complementada depois sem perder a auditoria anterior.
  • Ligação e conversa entram pelo mesmo caminho. Voz que chega transcrita segue exatamente a rota do texto, o que significa que integrar voz-com-transcrição é tão simples quanto integrar WhatsApp.