Pular para o conteúdo
Atalho: /, ⌘K ou Ctrl+K

Destinos

Envie os logs do projeto ou as análises por hora dos números para o seu endpoint HTTPS.

Ver em Markdown

Os destinos encaminham novos dados do projeto para o seu próprio receptor. Abra Configurações do projeto → Destinos para inspecionar os destinos, o status de entrega e os erros. A página do produto Drains explica as origens de dados, as configurações de destino e os formatos de entrega assinada.

Escolha a origem dos dados#

Cada destino tem uma origem:

OrigemDadosConfiguração
LogsRequisições de API, atualizações de números e entregas de webhookRegras de amostragem ordenadas selecionam quais registros novos são encaminhados.
AnálisesAgregados por número de mensagens, engajamento, chamadas e atividadeEscolha todos os números do projeto ou um número, com uma janela móvel de 1, 24 ou 168 horas.

As Análises precisam estar ativadas antes de você ativar um destino de análises. Os Logs não exigem as Análises. Nenhuma das origens inclui o corpo das mensagens, a identidade dos contatos ou credenciais. Os retratos de análises são preparados a cada hora para a última hora UTC concluída. Janelas móveis sobrepostas são observações; somá-las conta a atividade em dobro.

Adicione um destino#

Proprietários e administradores da equipe gerenciam os destinos. Os membros veem os metadados dos destinos com as URLs de destino e os nomes dos cabeçalhos personalizados ocultos. Um projeto aceita até cinco destinos, somando as duas origens.

  1. Selecione Adicionar destino e escolha Logs ou Análises.
  2. Selecione Endpoint personalizado e informe um nome e uma URL HTTPS pública.
  3. Escolha JSON ou NDJSON. Um segredo de assinatura é gerado; copie-o para o seu receptor antes de salvar. Você pode substituí-lo, gerá-lo de novo ou apagá-lo para entregas sem assinatura.
  4. Adicione cabeçalhos personalizados se o seu receptor exigir.
  5. Selecione Adicionar destino.

Para Análises, escolha também o escopo de números e a janela móvel. A origem, o escopo de números, a janela e a codificação ficam fixos na criação; crie um novo destino para alterá-los. Os segredos de assinatura salvos e os valores dos cabeçalhos personalizados não são retornados na visualização da configuração. As integrações nativas estão marcadas como Em breve.

Aceite uma entrega#

O seu receptor recebe um POST HTTPS. JSON usa application/json e um envelope {version, deliveryId, records}. NDJSON usa application/x-ndjson e um envelope {version, deliveryId, record} terminado por uma quebra de linha.

  • Quando um segredo de assinatura estiver configurado, verifique o HMAC-SHA256 calculado sobre o horário, um ponto e o corpo original da requisição. Inclua a quebra de linha final do NDJSON. Rejeite horários antigos e compare em tempo constante. Entregas sem assinatura não têm assinatura HMAC da Polymorfa.
  • Elimine duplicatas pelo Idempotency-Key, que corresponde ao deliveryId.
  • Retorne 2xx depois de aceitar o registro de forma durável. A entrega acontece pelo menos uma vez.
  • Outras respostas e falhas de conexão usam um número limitado de novas tentativas, com no máximo seis tentativas e não depois de 24 horas da entrada na fila.

Consulte envelopes de entrega e verificação de assinatura para ver os bytes exatos, os cabeçalhos e o cronograma de novas tentativas, e os campos do retrato de análises para ver a carga das análises.

Inspecione e pause#

A lista de destinos mostra o status ativado ou pausado, as contagens de entregas pendentes e com falha e o último status HTTP ou erro registrado. Pausar interrompe novas entradas na fila e novos claims de entrega; uma requisição em andamento pode terminar. Retomar continua as entregas elegíveis que estão na fila. Excluir remove o destino e as entregas dele que estão na fila.

Desativar as Análises exclui os retratos de análises na fila e interrompe a nova coleta. Reativar inicia um novo período de consentimento. Os dados que o seu receptor já aceitou seguem a sua própria política de retenção.

Colete métricas#

Use a configuração do OpenTelemetry quando o seu destino espera métricas OTLP. O receptor Prometheus dela coleta medidores por janela; um destino envia os envelopes JSON ou NDJSON da Polymorfa. Eles usam formatos de receptor diferentes.

Dados de dispositivos e conversas#

Os retratos de análises incluem deviceAnalytics e conversationBreakdown para cada número do escopo e para o resumo combinado. As linhas combinadas de conversa mantêm a faixa de conclusão, o código de chamada do país, o tipo de mensagem, a faixa de tamanho, a origem do envio, a classe de quantidade de dispositivos observada do cliente, as contagens de resultados e a latência total de resposta. Elas não contêm conteúdo de mensagens nem a identidade dos destinatários.

Um destino envia o retrato do escopo. Aplique predicados de categoria às linhas combinadas dele para construir (build) as suas próprias visualizações filtradas. JSON e NDJSON trazem os mesmos campos de dados.