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 RCS para empresas Developer Console y haz clic en Partner account settings. Desde aquí, 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 campo owner_name). Los operadores lo usarán para identificarte como socio de confianza y generar la información de facturación correcta para que uses RCS para empresas y llegues a sus suscriptores. El nombre que proporciones aquí debe coincidir con el que se usa en tus contratos de mensajería con el operador.
Punto de contacto técnico

Persona con la que se comunicará 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 webhook. Haz clic en Configurar para actualizarlo. Cuando configuras tu webhook de socio, se aplica a todos tus agentes. Si quieres usar un webhook diferente para un agente individual, puedes configurar un webhook del agente que solo se aplicará a ese agente.

Administrar marcas

Como socio de RCS para empresas, puedes crear agentes en nombre de marcas.

Usa la página Marcas en la sección 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:

  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 los cambios y haz clic en Listo.

Cómo quitar una marca

No se puede quitar una marca si está asociada a 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.

Administrar usuarios

En la página Usuarios de la sección 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 funciones de Developer Console para administrar todos los agentes que pertenezcan 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 correspondiente.
  2. Selecciona Quitar usuario.
  3. Confirma la eliminación.

El usuario que quitaste recibirá un correo electrónico en el que se le notificará que ya no tiene acceso a la cuenta de socio.

No puedes quitar a un usuario con el rol de propietario. Para cambiar o quitar al propietario, debes comunicarte con el equipo de asistencia.

Cambiar la función de un usuario

Sigue estos pasos para actualizar el rol de un usuario:

  1. Busca el usuario que deseas actualizar y haz clic en el botón en la fila de la tabla correspondiente.
  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 RB, 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 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 descargará la clave de la cuenta de servicio.

Almacena la clave de tu cuenta de servicio en una ubicación privada y segura. 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

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

Si deseas obtener orientación para procesar webhooks de forma asíncrona y evitar fallas en la entrega, consulta Control de mensajes.

Cómo verificar 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 de los mensajes.

Para verificar que Google haya enviado un mensaje que recibiste, sigue estos pasos:

  1. Extrae el encabezado X-Goog-Signature del mensaje. Es una copia con hash y 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 lo configuraste) 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 que creaste.
    • Si los hashes coinciden, confirmaste que Google envió el mensaje.

    • Si los hashes no coinciden, revisa el proceso de codificación hash en un mensaje que se sepa que funciona correctamente.

      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