[POST] Criar ação de transferência

📍 Create Handover Action

Cria uma ação de transferência (handover) dentro de um estágio do agente. Pode ser do tipo redirect (redirecionar para outro canal) ou takeover (assumir a conversa).

---

Endpoint

POST /v1.1/api/agent-service-chat-stage-handover/create

---

Headers

Header	Tipo	Obrigatório	Descrição
Authorization	String	Sim	Token JWT
Content-Type	String	Sim	application/json

---

Body

{
  "action": "takeover",
  "agentId": 15792,
  "chatStageId": "adbb0b04-3c4b-4770-9445-489509d00c14",
  "ddi": null,
  "message": "Transferindo para um atendente humano",
  "name": "Handover Suporte",
  "url": null,
  "whatsappNumber": "[phone]"
}

Campo	Tipo	Obrigatório	Descrição
action	Enum	Sim	Tipo da ação: redirect ou takeover
agentId	Int	Sim	ID do agente
chatStageId	String	Sim	ID do estágio
ddi	String	Não	Código de discagem internacional (quando aplicável)
message	String	Sim	Mensagem enviada ao usuário na transferência
name	String	Sim	Nome da ação
url	String	Não	URL de destino (se for redirect)
whatsappNumber	String	Não	Número de WhatsApp (se aplicável)

---

📥 Respostas

✅ 200 - Sucesso

{
  "action": "takeover",
  "chatStageId": "adbb0b04-3c4b-4770-9445-489509d00c14",
  "ddi": null,
  "id": "handover001",
  "message": "Transferindo para um atendente humano",
  "name": "Handover Suporte",
  "url": null,
  "whatsappNumber": "[phone]"
}

❌ 403

{ "error": "Usuário não autorizado" }

❌ 404

{ "error": "Estágio não encontrado" }