> ## Documentation Index
> Fetch the complete documentation index at: https://docs.polymorfa.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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](https://www.polymorfa.com/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.

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](/pt-br/console/log-forwarding#receba-as-entregas)
para ver os bytes exatos, os cabeçalhos e o cronograma de novas tentativas, e os
[campos do retrato de análises](/pt-br/console/analytics-collectors#enviar-retratos-json-por-hora)
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](/pt-br/console/analytics-collectors) 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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.