API Enviar Arquivo no Chat Interno

Envia um arquivo no chat interno, em nome de um usuário da equipe.

Esta chamada usa o Token da Empresa, gerado no menu Configurações → Token da Empresa — o token de uma Conexão não é aceito. E aqui não se informa Conexão: o chat interno é conversa entre a equipe e não sai por canal nenhum.

API: Todas

Endpoint

https://api.talkz.ai/api/chat-interno/chats/{chatId}/files

Método

POST

Autenticação

Bearer {seutokenaqui}

Payload

{
    "url": "https://seusistema.com.br/arquivos/fatura-outubro.pdf",
    "userId": 7,
    "message": "Segue a fatura de outubro.",
    "fileName": "fatura-outubro.pdf",
    "mentions": [12],
    "quotedMsgId": 0
}

O chatId é o ID da conversa, que vem na listagem das conversas.

“url”: endereço de onde baixar o arquivo, começando com http:// ou https://. Obrigatório.

O arquivo pode ter até 64 MB. Se o endereço não entregar o arquivo, a chamada é recusada.

Ele fica guardado na pasta da empresa, como os enviados pelo painel.

“userId”: ID de quem envia, que precisa ser usuário da empresa e participar daquela conversa. Obrigatório.

“message”: a legenda que acompanha o arquivo.

Imagem, vídeo, áudio e documento aparecem na conversa do mesmo jeito que no painel.

“fileName”: o nome do arquivo na conversa. Sem ele, vale o nome original ou o fim do endereço.

“mentions”: IDs dos participantes a mencionar, que são notificados.

“quotedMsgId”: ID de uma mensagem daquela mesma conversa, para responder citando.

Dá para enviar o arquivo direto, em vez do endereço. Nesse caso a chamada vai como multipart/form-data, com o arquivo no campo file e os mesmos campos acima — só que mentions vira uma lista separada por vírgula, como 3,5.

Utilize o código em requisições HTTPS com ferramentas como cURL ou bibliotecas de integração.

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://api.talkz.ai/api/chat-interno/chats/{chatId}/files',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
    "url": "https://seusistema.com.br/arquivos/fatura-outubro.pdf",
    "userId": 7,
    "message": "Segue a fatura de outubro.",
    "fileName": "fatura-outubro.pdf",
    "mentions": [12],
    "quotedMsgId": 0
}',
  CURLOPT_HTTPHEADER => array(
    'Content-Type: application/json',
    'Authorization: Bearer {seutokenaqui}' //Token da Empresa
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;
Copiar como cURL