Una vez que te registres como socio de RBM, tendrás una cuenta de socio. Para acceder a la configuración de la cuenta de socio, abre la Consola para desarrolladores de Business Communications y haz clic en Configuración de la cuenta de socio. Desde allí, puedes hacer lo siguiente:
- Actualiza la información de tu cuenta de socio
- Cómo agregar, editar y quitar las marcas vinculadas a tu cuenta
- Cómo administrar usuarios de cuentas
- Crea una cuenta de servicio y una clave para autenticar las llamadas a la API
Actualiza la información de la cuenta de socio
En la página Configuración, puedes ver tu ID de socio y actualizar la siguiente información:
| Campo | Descripción |
|---|---|
| Nombre del socio | Nombre de tu cuenta de socio |
| Nombre visible | El nombre aparecerá en los
informes de facturación de RBM que reciben los operadores (como el campo
owner_name). Los operadores usarán esta información para identificarte como socio de confianza y
asegurarse de que generan la información de facturación correcta para que uses RBM para llegar a sus suscriptores. El nombre que proporciones aquí debe coincidir con el que se usa en los contratos de tu operador de mensajería. |
| Punto de contacto técnico | La persona con la que Google se comunicará en caso de que haya problemas técnicos con tus agentes. Puedes actualizar su
|
| Webhook | Esta es la URL del extremo de tu webhook. Haz clic en **Configurar** para actualizarlo. Cuando configuras tu webhook de socio, se aplica a todos tus agentes. Si deseas usar un webhook diferente para un agente individual, puedes configurar un webhook de agente que solo se aplicará a ese agente. |
Administrar marcas
Como socio de RBM, puedes crear agentes en nombre de marcas.
Usa la página Marcas en la Configuración de la cuenta para agregar, editar y quitar las marcas asociadas con tu cuenta de socio.
Agregar una marca
Para agregar una marca, ingresa su nombre en el campo de entrada y haz clic en Agregar.
Cómo editar una marca
Para editar una marca, sigue estos pasos:
- Haz clic en la casilla de verificación junto al nombre de la marca.
- Haz clic en el botón y, luego, en Editar nombre.
- Realiza los cambios necesarios y haz clic en Listo.
Cómo quitar una marca
No se puede quitar una marca si está asociada con un agente, incluso si el agente no se lanzó.
Para quitar una marca, haz clic en la casilla de verificación junto a su nombre y, luego, en Borrar.
Administración de usuarios
En la página Usuarios de Configuración de la cuenta, puedes administrar los usuarios de tu cuenta de socio. El usuario que creó la cuenta de socio tiene la función de propietario. Los usuarios nuevos pueden tener el rol de Administrador o Lector.
- Los administradores pueden acceder a todas las capacidades de Play Console para administrar todos los agentes que pertenezcan a la cuenta de socio.
- Los lectores tienen acceso de solo lectura a Play Console para ver todos los agentes que pertenecen a la cuenta de socio.
Agrega un usuario
Para agregar un usuario, ingresa su dirección de correo electrónico en el campo de entrada y selecciona su Rol.
Cuando agregas un usuario nuevo, este recibe un correo electrónico en el que se le notifica que tiene acceso a la cuenta de socio.
Quitar un usuario
Sigue estos pasos para quitar usuarios:
- Busca el usuario que deseas quitar y haz clic en el botón en la fila de su tabla.
- Selecciona Quitar usuario.
- Confirma la eliminación.
El usuario que quitaste recibe un correo electrónico en el que se le notifica que ya no tiene acceso a la cuenta de socio.
No puedes quitar a un usuario con un rol de propietario. Para cambiar o quitar el propietario, comunícate con el equipo de asistencia.
Cómo cambiar la función de un usuario
Sigue estos pasos para actualizar el rol de un usuario:
- Busca el usuario que deseas actualizar y haz clic en el botón en la fila de su tabla.
- Selecciona Editar rol.
- Elige un rol nuevo en el menú desplegable.
- Haz clic en Guardar.
Configura una cuenta de servicio para autenticar llamadas a la API
Cuando realizas llamadas a la API de RBM, autenticas las llamadas con una clave de cuenta de servicio. Esta clave te permite crear y administrar marcas y agentes, y enviar mensajes y solicitudes como agente.
Sigue estos pasos para generar una clave de cuenta de servicio:
- En Configuración de la cuenta, navega a la página Cuenta de servicio.
- Haz clic en Crear clave y, luego, en Crear. Tu navegador descargará la clave de la cuenta de servicio.
Almacena la clave de tu cuenta de servicio en una ubicación segura y privada. No compartas tu clave públicamente. Necesitarás esta clave más adelante para acceder a las APIs de RBM.
Configura tu webhook de socio
Un webhook es una devolución de llamada HTTPS creada por un socio que especifica cómo debe responder tu agente a los mensajes y eventos. Una vez que configures tu webhook, podrás comenzar a recibir mensajes y eventos.
Para configurar tu webhook de socio, sigue estos pasos:
Abre la consola para desarrolladores de Business Communications y accede con tu Cuenta de Google de socio de RBM.
Abre Configuración de la cuenta.
En URL de webhook de RCS Business Messaging, haz clic en Configurar.
En URL de extremo de webhook, ingresa la URL de webhook que comience con “https://”.
Anota tu valor de
clientToken. Lo necesitas para verificar que los mensajes que recibes provengan de Google.Configura tu webhook para que acepte una solicitud
POSTcon el parámetroclientTokenespecificado y envíe una respuesta200 OKcon el valor de texto sin formato del parámetrosecretcomo cuerpo de la respuesta.Por ejemplo, si tu webhook recibe una solicitud
POSTcon el siguiente contenido del cuerpo{ "clientToken":"SJENCPGJESMGUFPY", "secret":"1234567890" }Luego, el webhook debería confirmar el valor
clientTokeny, siclientTokenes correcto, mostrar una respuesta200 OKcon1234567890como cuerpo de la respuesta:// clientToken from Configure const myClientToken = "SJENCPGJESMGUFPY"; // Example endpoint app.post("/rbm-webhook", (req, res) => { const msg = req.body; if (msg.clientToken === myClientToken) { res.status(200).send(msg.secret); return; } res.send(400); });En Play Console, haz clic en Verificar. Cuando RBM verifica tu webhook, se cierra el diálogo.
Verifica los mensajes entrantes
Debido a que los webhooks pueden recibir mensajes de cualquier remitente, debes verificar que Google haya enviado mensajes entrantes antes de procesar el contenido del mensaje.
Para verificar que Google envió un mensaje que recibiste, sigue estos pasos:
- Extrae el encabezado
X-Goog-Signaturedel mensaje. Esta es una copia con hash codificada en base64 de la carga útil del cuerpo del mensaje. - Decodifica en base 64 la carga útil de RBM en el elemento
message.bodyde la solicitud. - Con el token de cliente de tu webhook (que especificaste cuando configuraste el webhook) como clave, crea una HMAC SHA512 de los bytes de la carga útil del mensaje decodificado en base64 y codifica en Base64 el resultado.
- Compara el hash
X-Goog-Signaturecon el hash que creaste.- Si los hash coinciden, confirmaste que Google envió el mensaje.
Si los hash no coinciden, verifica tu proceso de hash en un mensaje que se considere bueno.
Si el proceso de generación de hash funciona correctamente y recibes un mensaje que crees que se te envió de forma fraudulenta, comunícate con nosotros.
Node.js
if ((requestBody.hasOwnProperty('message')) && (requestBody.message.hasOwnProperty('data'))) {
// Validate the received hash to ensure the message came from Google RBM
let userEventString = Buffer.from(requestBody.message.data, 'base64');
let hmac = crypto.createHmac('sha512', CLIENT_TOKEN);
let data = hmac.update(userEventString);
let genHash = data.digest('base64');
let headerHash = req.header('X-Goog-Signature');
if (headerHash === genHash) {
let userEvent = JSON.parse(userEventString);
console.log('userEventString: ' + userEventString);
handleMessage(userEvent);
} else {
console.log('hash mismatch - ignoring message');
}
}
res.sendStatus(200);
Próximos pasos
Ahora que tu cuenta de socio está configurada, es hora de compilar tu primer agente.