Configura tu cuenta de socio

Una vez que te registres como socio de RCS para empresas, tendrás una cuenta de socio. Para acceder a la configuración de tu cuenta de socio, abre la Consola para desarrolladores de RCS para empresas y haz clic en Configuración de la cuenta de socio. Desde allí, puedes hacer lo siguiente:

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 que reciben los operadores (como el owner_name campo). Los operadores lo usarán para identificarte como socio de confianza y generar la información de facturación correcta para tu uso de RCS para empresas para llegar a sus suscriptores. El nombre que proporciones aquí debe coincidir con el que se usa en tus contratos de mensajería de operadores.
Punto de contacto técnico

Persona a la que contactará Google si hay problemas técnicos con tus agentes. Puedes actualizar su

  • Nombre
  • Dirección de correo electrónico empresarial
  • Número de teléfono
Webhook Esta es la URL del extremo de tu webhook. Haz clic en Configurar para actualizarla. 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.

Administra marcas

Como socio de RCS para empresas, puedes crear agentes en nombre de las 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.

Editar una marca

Para editar una marca, sigue estos pasos:

  1. Haz clic en la casilla de verificación junto al nombre de la marca.
  2. Haz clic en el botón y, luego, en Editar nombre.
  3. Realiza las modificaciones y haz clic en Listo.

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 al nombre de la marca y, luego, en Borrar.

Administra usuarios

En la página Usuarios de la configuración de la cuenta puedes administrar los usuarios de tu cuenta de socio. El usuario que creó la cuenta de socio tiene el rol de propietario. Los usuarios nuevos pueden tener el rol de administrador o lector.

  • Los administradores pueden acceder a todas las capacidades de la Consola para desarrolladores para administrar todos los agentes que pertenecen a la cuenta de socio.
  • Los lectores tienen acceso de solo lectura a la Consola para desarrolladores 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:

  1. Busca al usuario que deseas quitar y haz clic en el botón en la fila de la tabla.
  2. Selecciona Quitar usuario.
  3. 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 un usuario con el rol de propietario. Para cambiar o quitar el propietario, debes comunicarte con el equipo de asistencia.

Cambiar la función de un usuario

Para actualizar el rol de un usuario, sigue estos pasos:

  1. Busca al usuario que deseas actualizar y haz clic en el botón en la fila de la tabla.
  2. Selecciona Editar rol.
  3. Elige un rol nuevo en el menú desplegable.
  4. Haz clic en Guardar.

Configura la cuenta de servicio para autenticar las 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. Una cuenta de servicio puede tener hasta 10 claves.

Para autenticar de forma segura las llamadas a la API, también necesitas la herramienta de línea de comandos oauth2l.

Sigue estos pasos para generar una clave de cuenta de servicio:

  1. En la configuración de la cuenta, navega a la página Cuenta de servicio.
  2. Haz clic en Crear clave y, luego, en Crear. El navegador descarga 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 de forma pública. Necesitarás esta clave más adelante para acceder a las APIs de RBM.

Configura tu webhook de socio

Para obtener información sobre cómo configurar tu webhook de socio, consulta la guía de webhooks.

Para obtener orientación sobre el procesamiento asíncrono de webhooks para evitar fallas en la entrega, consulta el control de mensajes.

Verifica los mensajes entrantes

Dado que los webhooks pueden recibir mensajes de cualquier remitente, debes verificar que Google haya enviado los mensajes entrantes antes de procesar el contenido del mensaje.

Para verificar que Google envió un mensaje que recibiste, sigue estos pasos:

  1. Extrae el encabezado X-Goog-Signature del mensaje. Esta es una copia hash codificada en base64 de la carga útil del cuerpo del mensaje.
  2. Decodifica en base64 la carga útil de RBM en el elemento message.body de la solicitud.
  3. Con el token de cliente de tu webhook (que especificaste cuando configuraste el webhook) como clave, crea un HMAC SHA512 de los bytes de la carga útil del mensaje decodificado en base64 y codifica el resultado en base64.
  4. Compara el hash X-Goog-Signature con el hash que creaste.
    • Si los hashes coinciden, confirmaste que Google envió el mensaje.

    • Si los hashes no coinciden, verifica el proceso de hashing en un mensaje que se sepa que es correcto.

      Si tu proceso de hashing 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
    const headerHash = req.header('X-Goog-Signature');
    const userEventString = Buffer.from(requestBody.message.data, 'base64');
    const hmac = crypto.createHmac('sha512', myClientToken);
    const genHash = hmac.update(userEventString).digest('base64');

    if (headerHash === genHash) {
      const userEvent = JSON.parse(userEventString);
      const webhookType = req.header('X-Goog-Webhook-Type');

      // Route based on the header type
      if (webhookType === 'message_callback') {
        handleMessage(userEvent);
      } else if (webhookType === 'agent_callback') {
        handleAgentEvent(userEvent);
      }
    } else {
      console.log('Hash mismatch - ignoring message');
      res.sendStatus(401);
      return;
    }
  }

  res.sendStatus(200);

Próximos pasos

Ahora que configuraste tu cuenta de socio, es momento de crear tu primer agente.

Anterior
Regístrate como socio
Siguiente
Compila tu primer agente