API Telegram - Método POST /create

Permite crear nuevos Workers con sus palabras.

¿Qué es un Worker?

Un Worker en TrawlingWeb es una entidad configurada por el usuario para realizar búsquedas específicas sobre los mensajes indexados de canales y grupos públicos de Telegram utilizando Palabras Clave. Estas Palabras Clave son términos de búsqueda configurados dentro del Worker y se basan en los créditos contratados (1 crédito = 1 Palabra Clave).

Creación y Configuración de Workers

El usuario puede crear y definir los términos de búsqueda para cada Worker directamente en el dashboard (https://dashboard.trawlingweb.com/workers) o utilizando el método proporcionado por la API. Una vez creado un Worker, este comienza a filtrar el flujo de mensajes indexados según sus palabras clave (los resultados empiezan a estar disponibles de forma prácticamente inmediata).

Funcionalidad de los Workers

• Palabras clave: Los Workers funcionan como una lista de palabras clave. Usan las Palabras Clave configuradas para filtrar el flujo de mensajes públicos indexados de Telegram.
• Proceso de búsqueda: Los Workers aplican las palabras clave sobre los campos text, user_name y user_screen_name de cada mensaje.
• Proceso de entrega: Cada vez que el cliente llama al Worker, este utiliza la lista de palabras clave para lanzar la búsqueda contra la base de datos de mensajes indexados por TrawlingWeb y recuperar solo aquellos resultados que tienen relación con la lista de palabras clave (combinables con filtros booleanos vía q=).

Implementar y gestionar Workers de manera eficiente permite a los usuarios maximizar la relevancia y precisión de los datos procesados, adaptándose a las necesidades específicas de sus análisis y monitoreo en Telegram.

Parámetros POST

Veamos la estructura de la consulta de ejemplo:

https://telegram.trawlingweb.com/create/?token={APIKEY}

Parámetros PATH:

Parámetros QUERY:

Parámetros BODY:

Estructura del parámetro words

El parámetro words debe enviarse como un array JSON de cadenas de texto, donde cada elemento del array representa una Palabra Clave. Cada Palabra Clave puede ser un término simple, una frase entre comillas o una mención (@usuario).

Ejemplo de body en formato JSON:

{
    "description": "Worker de ejemplo para monitoreo de marca",
    "words": [
        "cocacola",
        "\"coca cola\"",
        "@cocacola"
    ]
}

En este ejemplo, el Worker se crea con 3 Palabras Clave:

1. Un término simple: "cocacola"
2. Una frase exacta: "coca cola"
3. Una mención: "@cocacola"

Cada elemento del array words consume 1 crédito (1 crédito = 1 Palabra Clave).

Respuesta de salida - RESPONSE

Una vez lanzada una petición a la API de Telegram ésta devolverá una respuesta estructurada de la siguiente forma:

Status 200 - Datos del retorno

Ejemplo de respuesta en formato json:

"response" : {
    "worker" : "...",
    "msg" : "created"
}

Status 400 - Datos del retorno

Ejemplo de respuesta en formato json:

"response" : {
    "error" : "..."
}

Mejores búsquedas con la sintaxis de Telegram

A diferencia de redes con hashtags estructurados, Telegram es principalmente texto plano: por eso la sintaxis efectiva para definir palabras clave se centra en términos exactos, frases entre comillas y menciones. Esta sintaxis permite filtrar resultados por términos, frases, menciones de cuenta y rangos temporales. Al definir palabras clave para un Worker, esta sintaxis maximiza la eficiencia y relevancia de los datos procesados por cada Worker.

Aquí tienes un listado de los elementos que puedes combinar con tus palabras clave al crearlas dentro de un worker:

Caracteres reservados en palabras de búsqueda

Los caracteres reservados son: + - = & | > < ! ¡ () {} [] ^ " ~ * ¿ ?: \ / ' -

Contacto

Si tienes alguna pregunta, necesitas asistencia, contratar o ampliar tus servicios por favor contacta con nosotros.

SAT (Soporte Técnico):

• Correo SAT
• Documentación Oficial

SAC (Soporte administrativo):

• Correo SAC

Sales (Soporte ventas):

• Correo Ventas