Guia Técnico: Como buscar um PDF via API e exibir no Chatbot – Blip | Blip Help

Índice

Para realizar o envio de arquivos (como boletos ou relatórios) gerados via API externa, é necessário configurar três etapas nas Ações do seu bloco no Builder:

Passo 1: Buscar os dados (Requisição HTTP)

Primeiramente, é necessário realizar uma requisição à API para obter a URL do arquivo.

1. No bloco desejado, vá na aba Ações.

2. Adicione uma Ação de Entrada (ou Saída, dependendo do fluxo).

3. Escolha Requisição HTTP;

4. Método: Selecione GET (ou POST, conforme a documentação da sua API).

5. URL: Insira o endpoint da API.

6. Cabeçalhos: Se sua API exigir autenticação (API Key, Bearer Token), insira aqui.

7. Corpo da Resposta: Defina o nome de uma variável para salvar o retorno.

Exemplo: respostaApi

Passo 2: Formatar para o WhatsApp (Executar Script)

O Blip exige que os dados sejam enviados no padrão LIME para garantir a renderização correta do arquivo. Utilize um Script para realizar essa conversão de formato:

1. Adicione uma ação de Executar Script:

2. Variável de Entrada: Insira a variável do passo anterior (respostaApi).

3. Script: Copie e cole o código abaixo (JavaScript):

JavaScript
function run(respostaApi) {
    try {
        // 1. Converte o texto da resposta em um objeto JSON
        var dados = JSON.parse(respostaApi);
        // 2. IMPORTANTE: Ajuste o caminho abaixo conforme o retorno da sua API
        // Exemplo: se sua API retorna { "documento": { "pdf": "https://..." } }
        // Você deve usar: dados.documento.pdf
        var linkDoArquivo = dados.link_do_pdf; 
        // 3. Monta a estrutura de "Media Link" para o WhatsApp
        var estruturaMensagem = {
            "type": "application/vnd.lime.media-link+json",
            "value": {
                "title": "Seu Boleto", // Título que aparece para o usuário
                "text": "Clique para baixar", // Texto de apoio
                "type": "application/pdf", // Tipo do arquivo
                "uri": linkDoArquivo // A URL extraída da API
            }
        };
        // 4. Retorna o JSON pronto para uso
        return JSON.stringify(estruturaMensagem);
    } catch (erro) {
        return null; // Retorna nulo em caso de erro
    }
}

4. Variável de Saída: Defina um nome para a variável que guardará o conteúdo pronto.

Exemplo: conteudoDinamico

Passo 3: Exibir para o Usuário (Conteúdo Dinâmico)

Exiba o resultado no fluxo seguindo estas etapas:

1. Acesse a aba Conteúdo do bloco atual.

2. Remova os balões de texto existentes, se houver.

3. Selecione a opção Conteúdo Dinâmico (ícone de engrenagem/lista):

4. Tipo (MIME Type): application/vnd.lime.media-link+json

5. Conteúdo: Insira a variável de saída do script entre chaves duplas.

Exemplo: {{conteudoDinamico}}

Para mais informações, acesse a discussão sobre o assunto em nossa comunidade ou os vídeos no nosso canal. 😃

Índice

Artigos relacionados