Actualizar perfil comercial en WhatsApp, con una API
Actualiza el perfil comercial de un número de teléfono. Los campos omitidos conservan su valor, y websites reemplaza los sitios web del perfil.
- Identificador
- whatsapp_update_business_profile
La llamada
POST https://connect.reportei.com/api/tools/whatsapp_update_business_profile/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"
}
}Tu sistema envía el id de la conexión de tu cliente y los argumentos de la tool. Los headers son los mismos de toda la API de Connect: el token de tu producto y el token de tu cliente.
Parámetros
Las descripciones de los parámetros siguen la documentación oficial de la app, en inglés.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| phone_number_id | string | Sí | Id of the business phone number, from List phone numbers. |
| messaging_product | string | Sí | Always whatsapp.Valores: whatsapp |
| about | string | No | Short text shown under the name, up to 139 characters. |
| address | string | No | Address of the business, up to 256 characters. |
| description | string | No | Description of the business, up to 256 characters. |
| string | No | Contact email of the business. | |
| websites | array | No | Up to 2 websites, with http or https. |
| vertical | string | No | Industry of the business.Valores: OTHER, AUTO, BEAUTY, APPAREL, EDU, ENTERTAIN, EVENT_PLAN, FINANCE, GROCERY, GOVT, HOTEL, HEALTH, NONPROFIT, PROF_SERVICES, RETAIL, TRAVEL, RESTAURANT, ALCOHOL, ONLINE_GAMBLING, PHYSICAL_GAMBLING, OTC_DRUGS |
Conexiones posibles
Tu cliente conecta su cuenta de WhatsApp una sola vez, con uno de los modos de abajo. La misma conexión sirve para todas las tools del toolkit.
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.
La respuesta
Si la llamada tiene éxito, Connect conserva el status y el cuerpo de la respuesta de la app. Los errores HTTP devueltos por la app usan el objeto {error, api_error}; la autenticación o validación pueden fallar antes de la ejecución. El header X-Toolkit-Execution-Id identifica la ejecución registrada, disponible en GET /api/tools/executions/{uuid}.
Lista para agentes de IA
El input de esta tool es un JSON Schema, disponible en GET /api/tools/whatsapp_update_business_profile. Se convierte en la definición de tool de tu agente sin conversión.
Otras 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.
Mira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
