Find WhatsApp Contact

Tipo: mosend-find-contact · Paquete: Mosend WhatsApp Activities v1.0.4 · Salida: List<object>

Busca contactos de la cuenta de Mosend por teléfono o por parte del nombre. Sirve para saber si un cliente ya existe en Mosend, qué etiquetas tiene, si aceptó recibir mensajes o cuándo fue su última actividad, antes de decidir qué enviarle.

Cómo funciona

Obtiene la sesión de Mosend de la integración integration y busca con el texto de query:

Si query tiene 8 dígitos o más, se trata como un teléfono: se buscan solo los dígitos (Mosend guarda los números sin +, espacios ni guiones). Así, +57 300 000 0001 y 573000000001 encuentran el mismo contacto.
Si no, se busca como texto (por ejemplo, parte del nombre).

Devuelve hasta max contactos (20 por defecto, 200 como máximo). Si no encuentra ninguno, devuelve una lista vacía (no es un error).

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
`integration`	`string`	—	Nombre de la cuenta de Mosend en Centro › Recursos › Integraciones del ambiente (sección Mensajería). Ej: `mosend`.
`query`	`string`	—	Teléfono en formato internacional o parte del nombre. Ej: `+57 300 000 0001`.

Parámetros opcionales

Parámetro	Tipo	Por defecto	Descripción
`max`	`int`	`20`	Cantidad máxima de resultados. Por defecto `20`; como máximo `200`.

Salida

Devuelve una List<object>, una entrada por contacto:

Campo	Descripción
`id`	Id del contacto en Mosend.
`name`	Nombre del contacto.
`phone`	Teléfono del contacto.
`email`	Correo, si Mosend lo tiene.
`tags`	Etiquetas del contacto en Mosend.
`optInStatus`	Estado del consentimiento para recibir mensajes.
`lastActivityAt`	Fecha de la última actividad del contacto.

Errores comunes

La actividad falla con estos mensajes, sin prefijo; captúralos con Try / Catch:

Mensaje	Causa y solución
`'…' es obligatorio.`	Falta un parámetro requerido (el mensaje nombra cuál).
`La integración de Mosend '…' no existe en este ambiente. Créala en Centro › Recursos › Integraciones.`	El nombre de `integration` no coincide con ninguna integración de Mosend del ambiente donde corre el robot. Revísalo en Centro › Recursos › Integraciones.
`Las actividades de Mosend necesitan el contexto de ejecución de Zoan Cloud (…).`	El proceso no corre desde Zoan Cloud ni desde el Designer con sesión iniciada.
`Zoan Cloud rechazó la sesión de Mosend para '…': HTTP …: …`	Zoan Cloud no pudo entregar la sesión de la integración (por ejemplo, la autorización OAuth caducó o se revocó). Reconecta la integración.
`Mosend rechazó la sesión (401). Vuelve a conectar la integración en Centro › Recursos › Integraciones.`	La API key o el token ya no son válidos. Reconecta la integración.
`Mosend denegó la operación (403): la cuenta no tiene el permiso. …`	La cuenta de Mosend no tiene permiso para esa operación.
`Se alcanzó el límite de solicitudes de Mosend (429). Reintenta más tarde.`	Demasiadas peticiones seguidas. Reintenta con Retry y una espera.
`Mosend respondió HTTP …: …`	Otro error de Mosend; el detalle (hasta 300 caracteres de la respuesta) va después de los dos puntos.

Ejemplo

Enviar la plantilla de bienvenida solo si el cliente todavía no está en Mosend:

Find WhatsApp Contact   integration = "mosend"   query = "+57 300 000 0001"   → output: contactos
If   condition = count(contactos) == 0
 └─ then:
      Send WhatsApp Template   integration = "mosend"   from = "+57 300 000 0000"
                               to = "+57 300 000 0001"   template = "bienvenida"
                               variables = ["Cliente de prueba"]

Actividades relacionadas

Send WhatsApp Template — escribirle al contacto.
List WhatsApp Templates — ver las plantillas disponibles.