Saltar al contenido principal

Guía Técnica: Cómo buscar un PDF vía API e mostrar en el Chatbot

  • Actualización

Índice

  1. Paso 1: Buscar los datos (Solicitud HTTP) 

  2. Paso 2: Formatear para WhatsApp (Ejecutar Script)

  3. Paso 3: Mostrar al Usuario (Contenido Dinámico) 

 

Para realizar el envío de archivos (como facturas o informes) generados vía API externa, es necesario configurar tres etapas en las Acciones de su bloque en el Builder:

 

Paso 1: Buscar los datos (Solicitud HTTP) 

Primeramente, es necesario realizar una solicitud a la API para obtener la URL del archivo.

  1. En el bloque deseado, vaya a la pestaña Acciones.

  2. Añada una Acción de Entrada (o Salida, dependiendo del flujo).

  3. Elija Solicitud HTTP;

  1. Método: Seleccione GET (o POST, según la documentación de su API).

  2. URL: Inserte el endpoint de la API.

  3. Encabezados: Si su API requiere autenticación (API Key, Bearer Token), insértelos aquí.

  4. Cuerpo de la Respuesta: Defina el nombre de una variable para guardar el retorno. 

    Ejemplo: respuestaApi

Paso 2: Formatear para WhatsApp (Ejecutar Script) 

Blip requiere que los datos sean enviados en el estándar LIME para garantizar la renderización correcta del archivo. Utilice un Script para realizar esta conversión de formato:

  1. Añada una acción de Ejecutar Script:

  1. Variable de Entrada: Inserte la variable del paso anterior (respuestaApi).

  2. Script: Copie y pegue el código siguiente (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
    }
}

  1. Variable de Salida: Defina un nombre para la variable que guardará el contenido listo. 

    Ejemplo: contenidoDinamico

Paso 3: Mostrar al Usuario (Contenido Dinámico) 

Muestre el resultado en el flujo siguiendo estas etapas:

  1. Acceda a la pestaña Contenido del bloque actual.

  2. Elimine los globos de texto existentes, si los hay.

  3. Seleccione la opción Contenido Dinámico (icono de engranaje/lista):

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

  2. Contenido: Inserte la variable de salida del script entre llaves dobles. 

    Ejemplo: {{contenidoDinamico}}

 

Para obtener más información, acceda a la discusión sobre el tema en nuestra comunidad o los vídeos en nuestro canal. 😃

Artículos relacionados