> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fetchhive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# WhatsApp

> Conecta mensajería, plantillas, medios y automatización de WhatsApp Business mediante tu cuenta conectada.

# WhatsApp

Usa esta app cuando tu flujo de trabajo necesite enviar mensajes a clientes de WhatsApp o administrar una cuenta de WhatsApp Business. Puedes enviar mensajes, trabajar con plantillas, gestionar medios y administrar flujos.

## Configuración

| Opción | Obligatorio | Descripción |
| - | - | - |
| Nombre | No | Etiqueta para el paso en el lienzo del flujo de trabajo. |
| Authentication | Sí | La cuenta de WhatsApp conectada que se usará para este paso. |
| Acción | Sí | La acción de WhatsApp a realizar (por ejemplo List phone numbers, Get phone number, Get business profile, List message templates). |
| Arguments | Sí | Campos de formulario por acción generados a partir del esquema de la acción. Cada campo de texto tiene un botón **Insert Variable** para insertar valores `{{placeholder}}`. Hay disponible una pestaña **Raw JSON** para uso avanzado. |
| When the step fails | No | Controla si el flujo de trabajo debe **Terminate Workflow** o **Continue** si este paso falla. |

Antes de configurar este paso, conecta WhatsApp en **Integrations** para tu espacio de trabajo usando el flujo de inicio de sesión. Si no hay ninguna conexión activa disponible, el paso muestra una advertencia con un enlace a **Integrations** en lugar del selector de cuenta.

## Formulario de Arguments

Cuando seleccionas una acción, la sección **Arguments** muestra un formulario impulsado por el esquema de entrada de la acción. Los campos que hacen referencia a registros existentes incluyen selectores desplegables.

Cambia a la pestaña **Raw JSON** cuando prefieras escribir a mano el objeto completo de argumentos. Los cambios en cualquiera de las pestañas se mantienen sincronizados.

## Acciones comunes

| Acción | Descripción |
| - | - |
| **List phone numbers** | Recupera todos los números de teléfono registrados en tu cuenta de WhatsApp Business. |
| **Get phone number** | Recupera información detallada de un número de teléfono de WhatsApp Business. |
| **Get business profile** | Recupera la información del perfil comercial para un número de teléfono de WhatsApp Business. |
| **List message templates** | Recupera todas las plantillas de mensaje para la cuenta de WhatsApp Business. |
| **Check template status** | Recupera el estado y los detalles de una plantilla de mensaje. |
| **Send message** | Envía un mensaje de texto a un usuario de WhatsApp. |
| **Send template message** | Envía un mensaje de plantilla a un usuario de WhatsApp. |
| **Get message history** | Recupera el historial de mensajes para un número de teléfono de WhatsApp Business. |
| **Upload media** | Sube un archivo multimedia a los servidores de WhatsApp. |
| **Get media info** | Recupera metadatos y un enlace de descarga para los medios subidos. |
| **Send media by ID** | Envía medios subidos previamente a un usuario de WhatsApp. |
| **List flows** | Lista todos los WhatsApp Flows asociados con la cuenta de WhatsApp Business. |

Las acciones destructivas, como eliminar registros, no están disponibles en el selector de acciones del flujo de trabajo.

## Salida

Este paso guarda la respuesta de WhatsApp como salida del paso. La forma de la respuesta depende de la acción.

Usa la referencia de salida completa en pasos posteriores:

```text theme={null}
{{STEP_IDENTIFIER.output}}
```

## Ejemplo

1. Abre **Integrations** y conecta WhatsApp si aún no lo has hecho.
2. Añade un paso **WhatsApp** a tu flujo de trabajo.
3. Selecciona una cuenta conectada en **Authentication**.
4. Elige **List phone numbers** en **Action**.
5. Completa los campos obligatorios. Usa **Insert Variable** para referenciar el valor de salida de un paso anterior en cualquier valor de campo.
6. Haz clic en **Run** en el encabezado del paso para probar la acción y luego revisa la carga útil devuelta en **Output**.

## Casos de uso

### Responder a un cliente

1. Get phone number
2. Send message
3. Get message history

### Crear y usar una plantilla

1. List message templates
2. Upsert message template
3. Send template message

### Gestionar medios compartidos

1. Upload media
2. Get media info
3. Send media by ID

## Notas

* Este paso depende de una integración de WhatsApp conectada en tu espacio de trabajo.
* El selector de acciones del flujo de trabajo muestra un conjunto seleccionado de acciones. Los agentes con la herramienta de WhatsApp pueden usar más de ellas.
* La pantalla de inicio de sesión puede mostrar branding de autorización de terceros.

## Usar WhatsApp como herramienta del agente

También puedes añadir WhatsApp como herramienta en el **Agent Editor**. Abre el agente, haz clic en **Add tool** y selecciona **WhatsApp**. En el panel de configuración de la herramienta, elige la cuenta conectada que el agente debe usar. El agente llama a acciones de WhatsApp cuando son relevantes para la conversación.

Consulta también: [Integrations](https://docs.fetchhive.com/es/workspace/integrations.md), [Creating and Editing](https://docs.fetchhive.com/es/workflows/creating-and-editing.md) y [Testing and Iteration](https://docs.fetchhive.com/es/workflows/testing-and-iteration.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.