Skip to main content
POST
/
chat
/
send
/
document
Enviar Documento
curl --request POST \
  --url https://api.example.com/chat/send/document

Descricao

Envia um documento de qualquer tipo. O documento deve estar codificado em base64 como octet-stream.

Request

Headers

token: SEU_TOKEN
Content-Type: application/json

Body

{
  "Phone": "5511999999999",
  "Document": "data:application/octet-stream;base64,JVBERi0xLjQK...",
  "FileName": "contrato.pdf"
}
CampoTipoObrigatorioDescricao
PhonestringSimNumero do telefone ou JID do grupo
DocumentstringSimDocumento em base64 (data URL)
FileNamestringSimNome do arquivo com extensao
IdstringNaoID personalizado da mensagem
ContextInfoobjectNaoInformacoes para responder mensagem

Response

Sucesso (200)

{
  "code": 200,
  "data": {
    "Details": "Sent",
    "Id": "ABC123DEF456",
    "Timestamp": "2024-01-15T10:30:00-03:00"
  },
  "success": true
}

Exemplo cURL

curl -X POST 'https://api.bliper.ai/chat/send/document' \
  -H 'token: SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "Phone": "5511999999999",
    "FileName": "relatorio.pdf",
    "Document": "data:application/octet-stream;base64,JVBERi0xLjQK..."
  }'

Tipos de Arquivo Comuns

ExtensaoDescricao
.pdfDocumento PDF
.doc / .docxMicrosoft Word
.xls / .xlsxMicrosoft Excel
.ppt / .pptxMicrosoft PowerPoint
.txtTexto simples
.zipArquivo compactado

Gerando Base64 de Documento

JavaScript

function fileToBase64(file) {
  return new Promise((resolve, reject) => {
    const reader = new FileReader();
    reader.readAsDataURL(file);
    reader.onload = () => {
      // Substituir MIME type por octet-stream
      const base64 = reader.result.replace(
        /^data:.*?;base64,/, 
        'data:application/octet-stream;base64,'
      );
      resolve(base64);
    };
    reader.onerror = error => reject(error);
  });
}

Python

import base64

def file_to_base64(file_path):
    with open(file_path, "rb") as file:
        encoded = base64.b64encode(file.read()).decode()
        return f"data:application/octet-stream;base64,{encoded}"

# Uso
base64_doc = file_to_base64("contrato.pdf")
O nome do arquivo (FileName) e obrigatorio e deve incluir a extensao correta.
Use sempre application/octet-stream como MIME type para documentos.