> For the complete documentation index, see [llms.txt](https://prometheo.gitbook.io/prometheo/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://prometheo.gitbook.io/prometheo/integraciones/google-sheets-formularios.md).

# Google Sheets - Formularios

Cómo enviar mensajes automáticos de WhatsApp desde una planilla de Google Sheets usando Prometheo, una plantilla aprobada por Meta y WhatsApp Business API oficial.

## Qué es

Google Sheets Forms, también llamado Google Sheets Outbound o saliente, sirve para que Prometheo envíe mensajes automáticos a contactos que cargás en una planilla de Google Sheets.

* Leads de campañas
* Bases de prospectos
* Mensajes post formulario
* Confirmaciones automáticas
* Reactivación de contactos
* Primer contacto comercial

**Lógica principal:**\
cada fila nueva cargada en la planilla puede disparar automáticamente un mensaje saliente.

## Cómo funciona

1. Preparás la planilla de Google Sheets
2. Conectás la cuenta de Google en Prometheo
3. Elegís el archivo y la columna de teléfonos
4. Seleccionás la plantilla de WhatsApp
5. Mapeás variables y cada fila nueva dispara el envío

## Requisitos

### Qué necesitás para usarlo

* Plan Pro o Enterprise.
* WhatsApp Business API oficial.
* Medio de pago cargado en Meta y asociado a la cuenta de WhatsApp.
* Plantilla aprobada por Meta.

{% hint style="warning" %}
**No funciona con QR:**\
esta integración no sirve para líneas conectadas por QR. Para este caso necesitás sí o sí API oficial.
{% endhint %}

## Qué hace exactamente

### Cómo trabaja Prometheo con la planilla

Tomás una planilla con contactos, la conectás con Prometheo, definís en qué columna están los teléfonos, elegís una plantilla de WhatsApp y, si esa plantilla tiene variables, asociás cada variable con una columna de la hoja.

{% hint style="info" %}
**Importante:**\
el costo de envío de plantillas y conversaciones no está incluido en el plan de Prometheo. Ese costo lo gestiona Meta.
{% endhint %}

## Paso a paso

### Cómo configurarlo en Prometheo

{% stepper %}
{% step %}

### Prepará la planilla

Armá una base ordenada en Google Sheets con encabezados claros en la fila 1 y una columna de teléfono bien definida.
{% endstep %}

{% step %}

### Conectá la cuenta de Google

Desde Prometheo conectás la cuenta de Google donde está el archivo que querés usar.
{% endstep %}

{% step %}

### Elegí el archivo correcto

Seleccioná la planilla desde la cual se van a tomar los nuevos registros.
{% endstep %}

{% step %}

### Indicá qué columna contiene los teléfonos

Prometheo necesita saber exactamente qué columna debe usar para tomar el número al que va a enviar el mensaje.
{% endstep %}

{% step %}

### Seleccioná la plantilla de WhatsApp

El mensaje saliente se envía usando una plantilla aprobada por Meta. No se usa texto libre para este flujo.
{% endstep %}

{% step %}

### Mapeá las variables de la plantilla

Si la plantilla tiene variables, asociá cada una con la columna correspondiente de la planilla.

| Plantilla     | Columna del Sheet |
| ------------- | ----------------- |
| {{1}}         | Nombre            |
| {{2}}         | Producto          |
| {% endstep %} |                   |

{% step %}

### Confirmá la integración

Una vez configurado todo, cada fila nueva que se agregue en esa planilla puede disparar automáticamente el envío al número correspondiente.
{% endstep %}
{% endstepper %}

## Cómo debe estar armada

### Estructura recomendada de la planilla

La hoja tiene que estar prolija y con una lógica clara por columna. Esto ayuda a que la integración lea bien los datos.

| Nombre | Telefono      | Producto     | Vendedor |
| ------ | ------------- | ------------ | -------- |
| Juan   | 5491133344455 | Seguro hogar | Lucía    |

{% hint style="success" %}
**Buenas prácticas:**\
encabezados simples, una columna para cada dato importante y una columna de teléfono bien identificada.
{% endhint %}

## Formato del teléfono

### Cómo debe estar cargado el número

El teléfono debe estar con código de país, código de área, todo seguido, sin puntos, sin guiones y sin el signo +.

| Correcto      | Incorrecto         |
| ------------- | ------------------ |
| 5491133344455 | +54 9 11 3334-4455 |

{% hint style="warning" %}
**Clave:**\
si los números no están bien formateados, el envío puede fallar aunque el resto esté bien configurado.
{% endhint %}

## Qué sí hace

### Automatización simple y operativa

Es ideal cuando otro equipo carga filas en una planilla y Prometheo se encarga de disparar el mensaje automáticamente sin desarrollo adicional.

## Qué no hace

### No es un chatbot normal

No está pensado para responder conversaciones abiertas como un asistente tradicional, sino para disparar mensajes salientes desde una base cargada en Sheets.

## Qué depende de Meta

### Plantillas y costos

Para funcionar necesitás una plantilla aprobada y una cuenta de Meta operativa con medio de pago configurado para WhatsApp.

## Importación correcta

### Cómo cargar un Excel sin romper la integración

Un error muy común es arrastrar un Excel a Google Drive y asumir que ya funciona como Google Sheets. Eso puede generar problemas de visibilidad o compatibilidad dentro de la integración.

{% hint style="success" %}
**Forma recomendada:**\
crear la planilla directamente en Google Sheets o importar el Excel desde Archivo > Importar > Subir archivo.
{% endhint %}

{% hint style="warning" %}
**Si no ves el archivo:**\
muchas veces pasa porque fue subido mal al Drive como Excel arrastrado, en vez de importado correctamente desde Sheets.
{% endhint %}

## Errores frecuentes

### Qué revisar si no está funcionando

| Problema                                 | Qué suele pasar                                                    | Qué revisar                                                                                               |
| ---------------------------------------- | ------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------- |
| No veo el archivo                        | La planilla no aparece en la integración.                          | Confirmá que sea un Google Sheet real y no un Excel arrastrado al Drive.                                  |
| No se envían los mensajes                | La integración parece estar bien, pero no sale nada.               | Revisá API oficial, medio de pago en Meta, plantilla aprobada, formato del número y columna de teléfonos. |
| No encuentra los datos                   | La hoja existe, pero las variables no se completan como esperabas. | Chequeá encabezados, nombres de columnas y mapeo de variables de la plantilla.                            |
| Tengo Ads funcionando pero esto no envía | El problema no parece venir de la cuenta publicitaria.             | Verificá específicamente el medio de pago de WhatsApp dentro de Meta.                                     |

## Cuándo conviene

### Casos donde más rinde

* Leads de campañas.
* Confirmaciones automáticas.
* Mensajes post formulario.
* Recupero o reactivación de contactos.
* Equipos comerciales que cargan leads manualmente.
* Procesos administrativos que terminan en una planilla.

## Cuándo no conviene

### Cuándo no es la mejor opción

* Si no querés usar WhatsApp API oficial.
* Si no querés trabajar con plantillas de Meta.
* Si necesitás una lógica mucho más compleja que una nueva fila en una planilla.
* Si buscás una herramienta para conversar libremente como chatbot.

## No confundir con

### Diferencia con otras integraciones de Google Sheets

| Integración                    | Para qué sirve                                                           |
| ------------------------------ | ------------------------------------------------------------------------ |
| Google Sheets lectura          | Para que el asistente consulte información de un archivo en tiempo real. |
| Google Sheets Forms / Outbound | Para enviar mensajes salientes a contactos cargados en una planilla.     |
| Google Sheets escritura        | Para que el asistente guarde datos en una planilla.                      |

## Resumen

### Lógica completa en 6 pasos

{% stepper %}
{% step %}

### Preparás una planilla con contactos

{% endstep %}

{% step %}

### Conectás Google Sheets en Prometheo

{% endstep %}

{% step %}

### Indicás la columna de teléfonos

{% endstep %}

{% step %}

### Elegís una plantilla aprobada

{% endstep %}

{% step %}

### Mapeás variables si hace falta

{% endstep %}

{% step %}

### Cada nueva fila puede disparar un mensaje saliente

{% endstep %}
{% endstepper %}

## Preguntas frecuentes

<details>

<summary>¿Funciona con QR?</summary>

No. Para Google Sheets Forms necesitás WhatsApp Business API oficial.

</details>

<details>

<summary>¿Puedo mandar cualquier texto libre?</summary>

No. El envío se hace usando una plantilla previamente aprobada por Meta.

</details>

<details>

<summary>¿Cada fila nueva dispara un mensaje?</summary>

Sí, esa es la lógica general de esta integración una vez configurada correctamente.

</details>

<details>

<summary>¿El costo de WhatsApp está incluido en Prometheo?</summary>

No. Prometheo habilita la automatización, pero los costos de plantillas y conversación los maneja Meta.

</details>

**Nota:** este tutorial está pensado para web/centro de ayuda. Se puede adaptar después a una versión breve para WhatsApp o a una versión más orientada a ventas, soporte o implementación.