Fontes via API
Uma fonte via API é uma lista de destinatários que vem de um sistema externo — o CRM, o ERP, o sistema de protocolos — buscada na hora do disparo. Serve para campanha que se repete ("todo dia às 8h, quem venceu ontem") sem ninguém subir planilha. Fica em Contatos › Fontes via API.
Criar uma fonte
Nova fonte tem três passos.
1. Conectar
Nome, URL da API, método (GET/POST) e a autenticação (sem, usuário e senha, token Bearer, header customizado, query string ou login e token: a plataforma faz o login com usuário e senha a cada busca e usa o token que a API devolve — é o caso de APIs cujo token vence em uma hora). Token e senha ficam guardados cifrados; headers extras não sensíveis vão numa caixa própria. Testar conexão faz uma chamada só e mostra o código HTTP, onde está a lista na resposta e os campos encontrados.

2. Modelo
Vincular a um modelo (recomendado): escolha o fornecedor e o template — a fonte passa a carregar as variáveis dele. Ou pular e declarar variáveis livres. A etiqueta vai para os grupos que cada busca gera.

3. Mapear
Onde está a lista de registros na resposta ($.contacts, ou $ se a resposta já é a lista), qual campo é o telefone, o nome, o identificador na origem (para não repetir contato e confirmar o consumo) e a etiqueta por contato. Os campos descobertos no teste são clicáveis. Ajustes avançados: agenda, paginação e limites. Pré-visualizar resultado busca uma página e mostra como os contatos ficariam.

O cartão da fonte

- Buscar agora — chama a API e monta um grupo com quem ela devolver. Nada é enviado.
- Execuções — cada busca: quando, gatilho (na mão, agendada ou pela campanha), recebidos, válidos, inválidos, duplicados, inseridos, e o que houve.
- Editar, Desativar/Ativar (fonte desativada não pode ser usada em campanha nova) e excluir.

Usar numa campanha
Em Para quem, escolha Fonte via API e a fonte. No lançamento a plataforma busca os contatos na origem, monta a lista e dispara. Em campanha que se repete, cada execução busca de novo — é o ponto da fonte.
