Desativar agente multiplas conversas

Documentation Index

Fetch the complete documentation index at: https://docs.superagentes.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

Desativar Agente em Múltiplas Conversas

​

Casos de uso

• Desativar agente em todas as conversas de um canal específico
• Atualizar status de todas as conversas de um agente
• Operações em lote para gerenciamento de conversas
• Transferência em massa para atendimento humano

​

Parâmetros de Query

​

Canais suportados

• whatsapp - WhatsApp
• website - Website/Chat
• telegram - Telegram
• email - Email
• api - API direta

​

Corpo da requisição

​

Valores aceitos para status

• UNRESOLVED - Conversa não resolvida
• RESOLVED - Conversa resolvida
• HUMAN_REQUESTED - Solicitação de atendimento humano

​

Exemplos de código

// Atualizar todas as conversas de WhatsApp para atendimento humano
const updateWhatsAppConversations = async () => {
  const response = await fetch('https://dash.superagentes.ai/api/conversations/update-status?channel=whatsapp', {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${seu_token_jwt}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      status: 'HUMAN_REQUESTED'
    })
  });
  
  const data = await response.json();
  return data;
};

// Atualizar todas as conversas de um agente específico
const updateAgentConversations = async (agentId) => {
  const response = await fetch(`https://dash.superagentes.ai/api/conversations/update-status?agentId=${agentId}`, {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${seu_token_jwt}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      status: 'RESOLVED'
    })
  });
  
  const data = await response.json();
  return data;
};

​

Exemplos de uso

​

1. Transferir todas as conversas de WhatsApp para humano

POST /api/conversations/update-status?channel=whatsapp
{
  "status": "HUMAN_REQUESTED"
}

​

2. Resolver todas as conversas de um agente específico

POST /api/conversations/update-status?agentId=agent-123
{
  "status": "RESOLVED"
}

​

3. Atualizar todas as conversas do workspace

POST /api/conversations/update-status
{
  "status": "UNRESOLVED"
}

​

Exemplo de resposta

{
  "count": 25,
  "message": "25 conversas foram atualizadas com sucesso"
}

​

Códigos de resposta

​

Notas importantes

• Esta operação é irreversível e afeta múltiplas conversas simultaneamente
• Use com cuidado ao especificar filtros para evitar atualizações indesejadas
• O número de conversas afetadas é retornado no campo count
• Apenas conversas do workspace atual são afetadas
• Se nenhum filtro for especificado, todas as conversas do workspace serão atualizadas

​

Filtros combinados

POST /api/conversations/update-status?channel=whatsapp&agentId=agent-123