# Requisição 1: Excluir uma campanha específica
curl -X DELETE "https://app.talkover.ai/api/v1/campaigns/campaign-uuid-1" \
-H "Authorization: Bearer talq_your_environment_token_here"
// Requisição 1: Excluir uma campanha específica
const response = await fetch('https://app.talkover.ai/api/v1/campaigns/campaign-uuid-1', {
method: 'DELETE',
headers: {
'Authorization': 'Bearer talq_your_environment_token_here'
}
});
const result = await response.json();
console.log(result);
{
"success": true,
"message": "Campanha excluída com sucesso"
}
Chamadas e Campanhas
Excluir Campanha
Excluir uma campanha específica permanentemente
DELETE
/
api
/
v1
/
campaigns
/
{campaign_id}
# Requisição 1: Excluir uma campanha específica
curl -X DELETE "https://app.talkover.ai/api/v1/campaigns/campaign-uuid-1" \
-H "Authorization: Bearer talq_your_environment_token_here"
// Requisição 1: Excluir uma campanha específica
const response = await fetch('https://app.talkover.ai/api/v1/campaigns/campaign-uuid-1', {
method: 'DELETE',
headers: {
'Authorization': 'Bearer talq_your_environment_token_here'
}
});
const result = await response.json();
console.log(result);
{
"success": true,
"message": "Campanha excluída com sucesso"
}
Excluir Campanha
Excluir uma campanha específica permanentemente. Esta operação remove a campanha e todos os dados associados, incluindo configurações, estatísticas e histórico de chamadas.Endpoint
DELETE /api/v1/campaigns/{campaign_id}
Parâmetros de caminho
string
obrigatório
O identificador único da campanha. Você pode encontrá-lo na lista de campanhas.
Cabeçalhos da requisição
string
obrigatório
Token Bearer para autenticação. Formato:
Bearer talq_your_environment_token_hereExemplos de Requisição
# Requisição 1: Excluir uma campanha específica
curl -X DELETE "https://app.talkover.ai/api/v1/campaigns/campaign-uuid-1" \
-H "Authorization: Bearer talq_your_environment_token_here"
// Requisição 1: Excluir uma campanha específica
const response = await fetch('https://app.talkover.ai/api/v1/campaigns/campaign-uuid-1', {
method: 'DELETE',
headers: {
'Authorization': 'Bearer talq_your_environment_token_here'
}
});
const result = await response.json();
console.log(result);
# Requisição 2: Excluir campanha com ID específico
curl -X DELETE "https://app.talkover.ai/api/v1/campaigns/550e8400-e29b-41d4-a716-446655440000" \
-H "Authorization: Bearer talq_your_environment_token_here"
// Requisição 2: Excluir campanha com ID específico
const campaign_id = '550e8400-e29b-41d4-a716-446655440000';
const response = await fetch(`https://app.talkover.ai/api/v1/campaigns/${campaign_id}`, {
method: 'DELETE',
headers: {
'Authorization': 'Bearer talq_your_environment_token_here'
}
});
const result = await response.json();
console.log(result);
Resposta
Resposta de Sucesso (200 OK)
{
"success": true,
"message": "Campanha excluída com sucesso"
}
Campos da Resposta
boolean
obrigatório
Indica se a operação foi bem-sucedida.
string
obrigatório
Mensagem de sucesso descrevendo a operação.
Respostas de erro
404 Não Encontrado
{
"success": false,
"message": "Campaign not found"
}
409 Conflito
{
"success": false,
"message": "Cannot delete campaign with active calls"
}
401 Não Autorizado
{
"success": false,
"message": "Unauthorized"
}
500 Erro do Servidor
{
"success": false,
"message": "Internal server error."
}
Códigos de erro
| Código | Descrição | Status HTTP |
|---|---|---|
CAMPAIGN_NOT_FOUND | Campanha especificada não existe | 404 |
CAMPAIGN_HAS_ACTIVE_CALLS | Campanha tem chamadas ativas e não pode ser excluída | 409 |
INVALID_TOKEN | Token de autenticação inválido ou ausente | 401 |
SERVER_ERROR | Erro interno do servidor ocorreu | 500 |
Regras de Exclusão
Campanhas em rascunho. Campanhas com status
draft podem ser excluídas a qualquer momento.Campanhas ativas. Campanhas com status
active só podem ser excluídas se não tiverem chamadas em andamento.Campanhas pausadas. Campanhas com status
paused podem ser excluídas se não tiverem chamadas ativas.Campanhas concluídas. Campanhas com status
completed podem ser excluídas a qualquer momento.Campanhas canceladas. Campanhas com status
cancelled podem ser excluídas a qualquer momento.Operação irreversível. Esta operação exclui permanentemente a campanha e todos os dados associados.
Notas Importantes
Perda de dados. Todos os dados da campanha serão perdidos permanentemente.
Verificação de chamadas. O sistema verifica se há chamadas ativas antes de permitir a exclusão.
Limpeza automática. Dados relacionados como arquivos e estatísticas são removidos automaticamente.
Confirmação necessária. Certifique-se de que deseja excluir a campanha antes de executar esta operação.
Melhores Práticas
- Confirme a exclusão - Certifique-se de que deseja excluir a campanha permanentemente
- Verifique chamadas ativas - Certifique-se de que não há chamadas em andamento
- Faça backup - Considere fazer backup dos dados importantes antes da exclusão
- Teste em ambiente de desenvolvimento - Teste a exclusão em ambiente de desenvolvimento primeiro
- Monitore impacto - Acompanhe como a exclusão afeta outros sistemas integrados
Endpoints relacionados
- Listar Campanhas:
GET /api/v1/campaigns - Criar Campanha:
POST /api/v1/campaigns - Obter Campanha:
GET /api/v1/campaigns/{campaign_id} - Atualizar Campanha:
PUT /api/v1/campaigns/{campaign_id} - Atualizar Status da Campanha:
PATCH /api/v1/campaigns/{campaign_id}/status - Fazer Chamada de Campanha:
POST /api/v1/campaigns/{campaign_id}/call
Esta página foi útil?