curl -X POST "https://app.talkover.ai/api/v1/campaigns/campaign-uuid/files" \
-H "Authorization: Bearer talq_your_environment_token_here" \
-F "[email protected]"
{
"success": true,
"data": {
"file_data_id": "list-uuid",
"status": "processing",
"row_count": 18342,
"warnings": []
},
"message": "File uploaded successfully. Processing in background."
}
Chamadas e Campanhas
Subir lista de contatos
Sobe um arquivo CSV como nova lista de contatos da campanha
POST
/
api
/
v1
/
campaigns
/
{campaign_id}
/
files
curl -X POST "https://app.talkover.ai/api/v1/campaigns/campaign-uuid/files" \
-H "Authorization: Bearer talq_your_environment_token_here" \
-F "[email protected]"
{
"success": true,
"data": {
"file_data_id": "list-uuid",
"status": "processing",
"row_count": 18342,
"warnings": []
},
"message": "File uploaded successfully. Processing in background."
}
Subir lista de contatos
Sobe um arquivo CSV como nova lista de contatos da campanha — o mesmo que Adicionar lista no painel. O arquivo é validado na hora e importado em segundo plano; use ofile_data_id retornado para acompanhar a importação em Consultar progresso da importação.
Endpoint
POST /api/v1/campaigns/{campaign_id}/files
Parâmetros de caminho
string
obrigatório
UUID da campanha.
Cabeçalhos da requisição
string
obrigatório
Token Bearer. Formato:
Bearer talq_your_environment_token_herestring
obrigatório
multipart/form-dataCorpo da requisição
file
obrigatório
Arquivo CSV (
.csv ou .txt). Até 20.000 linhas e 25 MB.Formato do arquivo
- O arquivo precisa de uma coluna
tocom os telefones. No painel, o mapeamento de colunas renomeia a sua coluna de telefone parato; pela API nada é renomeado, então envie o cabeçalho comoto. - Toda outra coluna vira variável do contato, com o cabeçalho exatamente como escrito: uma coluna
Nomeé{Nome}no prompt do agente. - Uma coluna opcional
sourcemarca a origem de cada contato (padrãoCSV). Uma coluna opcionalallow_duplicatesdeixa a linha entrar mesmo com o número já pendente na campanha. - Números na lista de não ligar da campanha, números já pendentes e números ainda em período de espera são pulados na importação.
- Ambientes de cobrança precisam de uma coluna de telefone (
to,phoneouphone_1,phone_2…) e de uma coluna de documento (document,cpf,cnpj…).
Exemplos
curl -X POST "https://app.talkover.ai/api/v1/campaigns/campaign-uuid/files" \
-H "Authorization: Bearer talq_your_environment_token_here" \
-F "[email protected]"
Resposta
202 Accepted — a lista foi guardada e a importação está na fila.
{
"success": true,
"data": {
"file_data_id": "list-uuid",
"status": "processing",
"row_count": 18342,
"warnings": []
},
"message": "File uploaded successfully. Processing in background."
}
warnings lista colunas com valores vazios (em branco, -, N/A…). Nunca bloqueiam o envio.
Respostas de erro
422 — Arquivo inválido
O arquivo foi recusado e nada foi importado: sem colunato, mais de 20.000 linhas, arquivo vazio, não é CSV ou acima de 25 MB.
{
"success": false,
"message": "CSV file must contain a 'to' column with phone numbers",
"errors": ["CSV file must contain a 'to' column with phone numbers"]
}
404 — Campanha não encontrada
A campanha não existe ou pertence a outro ambiente.Esta página foi útil?