Destinos
Envie os logs do projeto ou as análises por hora dos números para o seu endpoint HTTPS.
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:
| Origem | Dados | Configuração |
|---|---|---|
| Logs | Requisições de API, atualizações de números e entregas de webhook | Regras de amostragem ordenadas selecionam quais registros novos são encaminhados. |
| Análises | Agregados por número de mensagens, engajamento, chamadas e atividade | Escolha 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.
- Selecione Adicionar destino e escolha Logs ou Análises.
- Selecione Endpoint personalizado e informe um nome e uma URL HTTPS pública.
- 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.
- Adicione cabeçalhos personalizados se o seu receptor exigir.
- 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 aodeliveryId. - 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.