Acción: petición HTTP¶

Con esta acción puedes interactuar con APIs y sitios web externos de manera flexible, enviando y recibiendo datos para integrarlos en tus bots de VisualMaker.

¿Qué puedes hacer con esta acción?¶

Obtener información dinámica en tiempo real:

Integra servicios como Google Maps, OpenWeather o APIs financieras para ofrecer a tus usuarios datos actualizados en cualquier momento.
Conexión sin límites:

Conecta tus bots con prácticamente cualquier servicio que ofrezca una API, como sistemas de pagos, servicios de mensajería, plataformas de clima, y más. ¡Las posibilidades son infinitas!
Crear bots inteligentes y útiles:

Haz que tu bot tome decisiones basadas en la información obtenida de las APIs. Por ejemplo, enviar recomendaciones personalizadas basadas en la ubicación o preferencias de los usuarios.
Ofrecer funciones avanzadas en tu bot:

Por ejemplo, puedes integrar un servicio de traducción, procesar pagos con plataformas como PayPal o Stripe, o incluso implementar asistentes virtuales usando inteligencia artificial.
Personalizar respuestas basadas en datos externos:

Haz que las respuestas de tu bot varíen según la información que obtenga del servicio externo, como responder con datos exclusivos del usuario o del contexto.

¿Cómo configurar la acción?¶

1. Crear la acción¶

Ve a tu bot y entra al editor pulsando 🛠 Editar.
Selecciona el botón o comando donde deseas agregar esta acción, o crea uno nuevo.
Ve a Acciones 🌟 → 🎯 Nueva acción → 🌐 Petición HTTP.
Pulsa en Configurar 🛠 para configurarla.

2. Configurar las opciones¶

➡️ `Método`¶

Elige el tipo de método HTTP, puede ser GET o POST.

➡️ `Body`¶

Elige el formato del cuerpo de la petición, puede ser JSON, data, o params.

➡️ `Establecer URL`¶

Especifica la URL a la que se enviará la petición.

➡️ `Establecer body` (opcional)¶

Define los datos que se enviarán en el cuerpo de la petición. Usa el formato adecuado, por ejemplo:

"nombre": "John"
"edad": 25
"usando_id": #Jsh4K.text#
"usando_expresión": "{first_name}"

➡️ `Establecer headers` (opcional)¶

Añade encabezados personalizados para la petición. Escribe cada encabezado en una línea nueva, con su valor separado por dos puntos, por ejemplo:

"Content-Type": "application/json"
"User-Agent": "Mozilla/5.0"

➡️ `Establecer cookies` (opcional)¶

Especifica cookies usando el mismo formato de los anteriores campos:

"Nombre-Cookie": "Valor-Cookie"

➡️ `Establecer proxy` (opcional)¶

Configura un proxy HTTP o SOCKS para realizar la petición.

Para proxies HTTP:

http://host:port

Para proxies SOCKS4:

socks4://host:port

Para proxies SOCKS5:

socks5://host:port

Si el proxy tiene usuario y contraseña, establécelo así:

socks5://user:password@host:port

3. Activar la acción¶

Pulsa ✅ Activar para activar esta acción y que quede funcional.

Datos dinámicos

Puedes usar expresiones, variables, e IDs de acciones previas para realizar peticiones dinámicas.

Se deben respetar los tipos de datos

Trabajar con diferentes tipos de datos

Textos, fechas, expresiones y variables: Deben colocarse entre comillas. Ejemplo:

"nombre": "John"
"fecha": "31-12-2024 23:59:59"
"usando_expresión_con_variable": "{first_name}"

Números, booleanos e ID de acciones: Se envían sin comillas. Ejemplo:
```
"edad": 25
"activo": True
"usando_id": #GhB2K.param1#
```

¿Qué devuelve la acción a través de su ID?¶

Respuesta en formato de texto: #IDAcción.text#
Respuesta en formato JSON: #IDAcción.json#
Código de estado de la petición: #IDAcción.status#

Remplaza IDAcción por el ID de esta acción (Petición HTTP).

Ejemplo práctico: Obtener el precio de BTC¶

En este ejemplo obtendremos el precio actual de Bitcoin desde la API de CoinMarketCap.

1. Crea un nuevo botón¶

Entra al modo editor pulsando 🛠 Editar en tu bot.
Pulsa en ✳️ Nuevo botón | comando.
Escribe el nombre del botón, por ejemplo: Precio BTC
Pulsa en Acciones 🌟 para configurar las acciones de este botón.

2. Agrega las acciones necesarias¶

a) Acción 1: Petición HTTP¶

Pulsa en 🎯 Nueva acción → 🌐 Petición HTTP.
Pulsa en Configurar 🛠 y establece lo siguiente:
- Método:
```
GET
```
- Body:
```
params
```
- Establecer URL:
```
https://pro-api.coinmarketcap.com/v1/cryptocurrency/quotes/latest
```
- Establecer body:
```
"symbol": "BTC"
"convert": "USD"
```
- Establecer headers:
```
"X-CMC_PRO_API_KEY": "tu_api_key_aquí"
```
  Reemplaza tu_api_key_aquí por tu API Key de CoinMarketCap, obtenla aquí.
Regresa al menú de acciones y activa esta acción pulsando en ✅ Activar.
Copia el ID de esta acción, lo necesitarás en un momento.

b) Acción 2: Enviar mensaje¶

Pulsa en 🎯 Nueva acción → ✉️ Enviar mensaje.
Pulsa en Configurar 🛠 → 💬 Establecer mensaje 💬 e ingresa:
```
El precio actual de Bitcoin es {fix(#IDAcción.json.data.BTC.quote.USD.price#, 3)} USD.
```
Nota 1: Reemplaza IDAcción por el ID de la acción de Petición HTTP que acabas de copiar.

Nota 2: Hemos usado la función fix() para limitar a 3 los decimales del número, puedes ver esta y todas las funciones aquí.
Regresa al menú de acciones y activa esta acción pulsando en ✅ Activar.

Resultado final¶

El usuario pulsa el botón Precio BTC.
El bot envía una petición GET a la API de CoinMarketCap.
Recibe una respuesta JSON con el precio de Bitcoin.

Muestra al usuario algo como:

El precio actual de Bitcoin es 104096.253 USD.

Importante

Ya VisualMaker tiene una acción para obtener el precio de cualquiera de las criptomonedas listadas en la billetera de VisualMaker, llamada Precio cripto. Por lo que, a menos que necesites obtener el precio de criptos no listadas, no es necesario usar CoinMarketCap o similares.