[POST] Criar Ação de Envio de Arquivo

📍 Create File Action

Este endpoint permite criar uma ação de envio de arquivos em um estágio do agente. É possível enviar até 5 arquivos por requisição.

---

Endpoint

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

---

Headers

Header	Tipo	Obrigatório	Descrição
Authorization	String	Sim	Token JWT no formato Bearer {token}
Content-Type	String	Sim	application/json ou multipart/form-data (dependendo da forma de envio dos arquivos)

---

Body

{
  "agentId": 15792,
  "batchName": "Documentos Iniciais",
  "chatStageId": "adbb0b04-3c4b-4770-9445-489509d00c14",
  "files": [
    {
      "name": "contrato.pdf",
      "reference": "storage://contratos/contrato.pdf",
      "type": "application/pdf"
    },
    {
      "name": "apresentacao.png",
      "reference": "storage://imagens/apresentacao.png",
      "type": "image/png"
    }
  ]
}

Campo	Tipo	Obrigatório	Descrição
agentId	Int	Sim	ID do agente
batchName	String	Sim	Nome do lote de arquivos
chatStageId	String	Sim	ID do estágio do chat
files	Array | Any	Sim	Lista de arquivos (mínimo 1, máximo 5)

---

Exemplo de Requisição

curl --location --request POST 'https://api.zaia.app/v1.1/api/agent-service-chat-stage-file/create' \
--header 'Authorization: Bearer {token}' \
--header 'Content-Type: application/json' \
--data '{
  "agentId": 15792,
  "batchName": "Documentos Iniciais",
  "chatStageId": "adbb0b04-3c4b-4770-9445-489509d00c14",
  "files": [
    {
      "name": "contrato.pdf",
      "reference": "storage://contratos/contrato.pdf",
      "type": "application/pdf"
    }
  ]
}'

---

📥 Respostas

✅ 200 - Sucesso

{
  "batchName": "Documentos Iniciais",
  "chatStageId": "adbb0b04-3c4b-4770-9445-489509d00c14",
  "createdAt": "2025-09-17T12:00:00Z",
  "files": [
    {
      "id": "f001",
      "name": "contrato.pdf",
      "reference": "storage://contratos/contrato.pdf",
      "type": "application/pdf"
    }
  ],
  "id": "a123",
  "isEnabled": true
}

❌ 403 - Proibido

{
  "error": "Usuário não autorizado a criar ação de envio de arquivos"
}

❌ 404 - Não encontrado

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