Tools de WhatsApp
Las 10 operaciones de WhatsApp que tu producto ejecuta en la cuenta de tu cliente con Connect. Todas usan el mismo endpoint, POST /api/tools/{tool}/execute.
- Listar cuentas comercialesGETLista las cuentas comerciales de WhatsApp a las que llega el usuario del sistema, con id y nombre. Ese id es el waba_id de las otras herramientas, que Meta ahora también llama Messaging account id. La respuesta trae data y paging.cursors.after: pásalo como after para leer la página siguiente.
- Obtener cuenta comercialGETDevuelve una cuenta comercial de WhatsApp con los campos pedidos, que pueden ser datos de la cuenta o analíticas. Sin fields, solo vuelven id y name.
- Listar números de teléfonoGETLista los números de teléfono comerciales de una cuenta comercial de WhatsApp con id, display_phone_number, verified_name y quality_rating. Ese id es el phone_number_id de las herramientas de mensaje y perfil. La respuesta trae data y paging.cursors.after: pásalo como after para leer la página siguiente.
- Enviar mensajePOSTEnvía un mensaje desde un número de teléfono comercial y devuelve su id en messages[0].id. Los tipos libres (text, image, video, document, audio) solo llegan a quien escribió al número en las últimas 24 horas; para iniciar una conversación, envía el tipo template con una plantilla aprobada de Listar plantillas de mensaje. Meta cobra los mensajes a la cuenta según sus precios de WhatsApp.
- Listar plantillas de mensajeGETLista las plantillas de mensaje de una cuenta comercial de WhatsApp con id, name, language, status, category y components. La respuesta trae data y paging.cursors.after: pásalo como after para leer la página siguiente.
- Crear plantilla de mensajePOSTCrea una plantilla de mensaje y la envía a revisión de Meta, devolviendo id, status y category. Se puede enviar cuando el estado sea APPROVED, lo que puede tardar hasta 24 horas. Las variables son {{1}}, {{2}} en el formato POSITIONAL o {{first_name}} en el formato NAMED, y cada una necesita un ejemplo. Un encabezado de imagen, vídeo o documento necesita un file handle de una subida, que esta conexión no hace.
- Actualizar plantilla de mensajePOSTEdita una plantilla y la envía de nuevo a revisión. Solo se pueden editar plantillas en estado APPROVED, REJECTED o PAUSED, y solo su categoría y components; components reemplaza todas las partes. Una plantilla aprobada admite hasta 10 ediciones en 30 días y 1 en 24 horas, y su categoría no puede cambiar.
- Eliminar plantilla de mensajeDELETEElimina una plantilla por nombre, en todos los idiomas, o solo la versión de idioma cuyo id es hsm_id. El nombre de una plantilla aprobada eliminada no se puede reutilizar durante 30 días.
- Obtener perfil comercialGETDevuelve el perfil comercial que ven las personas en un número de teléfono: about, address, description, email, websites, vertical y profile_picture_url.
- Actualizar perfil comercialPOSTActualiza el perfil comercial de un número de teléfono. Los campos omitidos conservan su valor, y websites reemplaza los sitios web del perfil.
Mira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
