Lista paginada de contactos de la cuenta Wasapi. Soporta búsqueda por texto o filtro por labels.

Obtiene un contacto por su wa_id (WhatsApp ID, p.ej. número de teléfono internacional sin +).

Crea un nuevo contacto en Wasapi. first_name es requerido. Incluir phone y country_code para enviar mensajes.

Actualiza un contacto existente. wa_id es requerido; los demás campos son opcionales.

Elimina un contacto por su wa_id. Operación irreversible.

Agrega una etiqueta (label) a un contacto. Usa contact_uuid (UUID del contacto) y label_id (número).

Quita una etiqueta (label) de un contacto. Usa contact_uuid (UUID del contacto) y label_id (número).

Lista los números de WhatsApp conectados a la cuenta Wasapi. Devuelve los from_id disponibles para enviar mensajes.

Envía un mensaje de texto por WhatsApp. from_id es opcional si WASAPI_FROM_ID está configurado como variable de entorno.

Envía una plantilla aprobada de WhatsApp a uno o más destinatarios. Soporta variables (body_vars/header_var/cta_var — consulta get_template_fields para conocerlas) y adjuntos por URL (url_file). from_id es opcional si WASAPI_FROM_ID está configurado.

Envía un archivo adjunto por WhatsApp desde una URL pública (imagen, video, audio o documento). El tipo se infiere de la extensión de la URL. from_id es opcional si WASAPI_FROM_ID está configurado.

Obtiene el hilo de mensajes con un contacto de WhatsApp (identificado por wa_id). Nota: no es un lookup por ID de conversación — el SDK identifica la conversación por contacto (wa_id). list_conversations no está implementado (SDK gap).

Asigna automáticamente un agente al contacto (rotación automática de Wasapi). Usa el contact_uuid del contacto.

Inicia una exportación de todos los contactos de la cuenta. Opcionalmente recibe emails a los que enviar el archivo exportado.

Lista todas las plantillas de WhatsApp de la cuenta.

Obtiene el detalle de una plantilla de WhatsApp por su UUID.

Obtiene los campos/variables que acepta una plantilla (útil antes de enviar con send_template y body_vars).

Lista las plantillas disponibles para un número de WhatsApp específico (from_id).

Sincroniza las plantillas desde Meta hacia Wasapi. Puede tardar; úsalo cuando creaste o editaste plantillas en Meta Business.

Cambia el estado de la conversación con un contacto: open, hold o closed. Opcionalmente asigna agente o envía mensaje de cierre.

Envía una o más tarjetas de contacto (vCard) por WhatsApp a un destinatario.

Lista todos los WhatsApp Flows de la cuenta.

Lista los WhatsApp Flows disponibles para un número específico (from_id; usa el default si se omite).

Envía un WhatsApp Flow interactivo a un contacto. Usa list_flows para descubrir flow_id y get_flow_screens para las pantallas.

Obtiene las respuestas que los usuarios enviaron a través de un WhatsApp Flow (paginado).

Obtiene el detalle y los assets de un WhatsApp Flow (definición, pantallas, si usa data API).

Lista las pantallas de un WhatsApp Flow (útil para elegir el parámetro screen de send_flow).

Lista todas las campañas de difusión de WhatsApp de la cuenta Wasapi.

Obtiene el detalle de una campaña por su UUID, incluyendo los envíos (jobs) por contacto y su estado. Usa list_campaigns para descubrir los UUID.

Lista todos los embudos (funnels) de venta de la cuenta Wasapi, con sus etapas.

Busca un contacto dentro de los embudos por número de teléfono o por contact_uuid. Devuelve en qué embudo y etapa está.

Mueve un contacto a otra etapa de un embudo. Usa search_contact_in_funnels para obtener el funnel_contact_id y list_funnels para los IDs de etapa.

Métrica: lista de agentes actualmente en línea.

Métrica: conteo de contactos por estado de conversación.

Métrica: total de campañas en un rango de fechas (YYYY-MM-DD).

Métrica: conversaciones consolidadas en un rango de fechas (YYYY-MM-DD).

Métrica: conversaciones por agente en un rango de fechas (YYYY-MM-DD).

Métrica: volumen de mensajes en un rango de fechas (YYYY-MM-DD).

Métrica: volumen de mensajes enviados por el bot en un rango de fechas (YYYY-MM-DD).

Métrica de un agente: tiempo de respuesta en un rango de fechas.

Métrica de un agente: conversaciones transferidas en un rango de fechas.

Métrica de un agente: volumen de trabajo en un rango de fechas.

Métrica de un agente: tiempo en conversación en un rango de fechas.

Activa o desactiva el chatbot para un contacto. action: 'enable' lo activa, 'disable' lo desactiva temporalmente, 'disable_permanently' lo desactiva de forma permanente. from_id es opcional si WASAPI_FROM_ID está configurado.

Lista los cambios de estado de conversaciones (workflow) con filtros opcionales por estado, teléfono, agente y rango de fechas.

Lista todos los campos personalizados (custom fields) de la cuenta.

Crea un campo personalizado nuevo con el nombre indicado.

Actualiza el nombre de un campo personalizado existente.

Elimina un campo personalizado por su ID. Operación irreversible.

Obtiene los datos de la cuenta/usuario asociado a la API key actual.

Lista todos los usuarios (agentes) de la organización: nombre, email, rol, permisos y números de WhatsApp asignados. Útil para ver el equipo o decidir a quién asignar una conversación. Requiere el permiso 'view agents' en la cuenta.

Lista las conversaciones de la cuenta (paginado por cursor) con filtros opcionales por estado, texto, teléfonos, etiquetas, agentes y fechas. Distinto de get_conversation, que trae el hilo de mensajes con un contacto puntual.

Obtiene la siguiente página de conversaciones usando el cursor devuelto por list_conversations.

Lista todas las etiquetas (labels) de la cuenta.

Busca una etiqueta por su nombre EXACTO (no es búsqueda parcial). Devuelve la etiqueta si el título coincide exactamente.

Obtiene una etiqueta por su ID.

Crea una etiqueta nueva con título, color y descripción opcional.

Actualiza una etiqueta existente (título, color, descripción).

Elimina una etiqueta por su ID. Operación irreversible.

Reporte de desempeño por agente en un rango de fechas. agent_id es un filtro opcional.

Reporte de volumen de workflow en un rango de fechas. from_id es un filtro opcional por número.

Reporte de encuestas de satisfacción en un rango de fechas. agent_id es un filtro opcional.