Comunicación
WhatsApp en tu producto y en tus agentes de IA, con una API
El toolkit de WhatsApp Cloud API cubre cuentas comerciales, números de teléfono, envío de mensajes, plantillas de mensaje y el perfil comercial de un número. Con Connect, tu producto o agente de IA lo llama todo por un solo endpoint, mientras Connect guarda las credenciales y registra cada ejecución.
15 días de prueba. Sin tarjeta de crédito.
POST https://connect.reportei.com/api/tools/whatsapp_send_message/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"phone_number_id": "<phone_number_id>",
"messaging_product": "whatsapp",
"recipient_type": "individual",
"to": "<recipient_number_with_country_code>",
"type": "text",
"text": {
"body": "Hello! This is an example message.",
"preview_url": false
}
}
}Cómo funciona
Del cliente conectado a la primera llamada a WhatsApp.
- 1
Tu cliente conecta la cuenta
Tu sistema abre una sesión de Connect para el toolkit y tu cliente conecta su cuenta de WhatsApp. Recibes el id de la conexión.
- 2
Tu producto llama a la tool
Un POST a /api/tools/{tool}/execute con el id de la conexión y los argumentos. Si la llamada tiene éxito, Connect conserva el status y el cuerpo de la respuesta de la app.
- 3
Connect se encarga del resto
Guarda la credencial cifrada, renueva tokens en conexiones OAuth que admiten renovación y registra las ejecuciones en un historial de auditoría disponible por API.
Casos de uso
Qué hace tu producto con WhatsApp.
Envía notificaciones con plantilla
Un SaaS inicia una conversación enviando un mensaje de tipo template con una plantilla aprobada, por ejemplo para confirmar un pedido.
Gestiona plantillas desde tu app
Un producto crea una plantilla de mensaje, la envía a revisión de Meta y luego la edita o elimina según cambia el contenido.
Responde a clientes con un agente
Un agente de IA responde con un mensaje de texto libre a quien escribió al número en las últimas 24 horas.
Tools
10 tools de WhatsApp
- 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.
Clave de API
Tu cliente pega la clave de la app en una pantalla de Connect, o tu sistema envía la clave con POST /api/customer-toolkits, sin pantalla.
Preguntas sobre el toolkit de WhatsApp
¿Necesito implementar la API de WhatsApp?
No. Connect ya trae 10 tools de WhatsApp descritas y listas. Tu cliente conecta la cuenta y tu sistema llama a cada tool por el mismo endpoint, con el mismo formato de solicitud.
¿Cómo conecta mi cliente su cuenta de WhatsApp?
Con el modo que acepta el toolkit: Clave de API. Connect guarda la credencial cifrada y nunca la devuelve a tu sistema.
¿Funciona con agentes de IA?
Sí. El input de cada tool está descrito en JSON Schema, que tu agente usa directamente como definición de tool. El agente elige la tool y los argumentos, y tu sistema hace la llamada a Connect.
¿Mi cliente necesita una cuenta en Reportei?
No. Tu cliente conecta la cuenta en una pantalla de Connect, o tu sistema envía la credencial por la API, y sigue usando solo tu producto.
Mira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
