Modificar y Gestionar Datos

¡Felicidades! Has configurado una conexión segura y recibido información de la plataforma. En los siguientes pasos abordaremos una tarea más compleja y desglosaremos cómo llevarla a cabo.

Actualizar un Destinatario

Supongamos que hemos enviado muchos documentos para ser firmados por clientes. Ocasionalmente, un documento rebota de la dirección de correo electrónico de un empleado antiguo o el cliente nos indica que otra persona es quien debe firmar. Necesitamos actualizar al destinatario — ¿podemos crear una herramienta para esto?

Necesitaremos estos argumentos:

• el id del documento (una clave en formato base64)
• el correo electrónico del destinatario antiguo
• el correo electrónico del usuario nuevo
• el nombre del usuario nuevo
• el apellido del usuario nuevo

Encontrar el ID del Destinatario

Si el usuario proporciona un documentId, buscaremos al destinatario por dirección de correo electrónico.

Obtener Destinatarios de un Documento

Una forma fácil de obtener un documentId de ejemplo desde Console es ir a la página de Detalles del Documento. Obtén el ID del documento de la URL después de /details/.

{
  document(id: "ZG9jMWVmMjdkYWYtMGJlMS0xMWYwLWJiDVCXMDZlNDc2YTA3NTY5") {
    id
    recipients {
      id
      email
      firstName
      lastName
    }
  }
}

Prueba las consultas en el GraphiQL Explorer antes de escribir código. Si ejecutas lo anterior con un ID inválido recibirás una advertencia NOSUCHID:

{
  "data": {
    "document": null
  },
  "errors": [
    {
      "errorType": "WARNING",
      "message": "NOSUCHID"
    }
  ]
}

Con un ID válido verás los destinatarios:

{
  "data": {
    "document": {
      "id": "ZG9jMWVmMjdkYWYtMGJlMS0xMWYwLWJiYjUtMDZlNDc2YTA3NTY5",
      "recipients": [
        {
          "id": "cmVjMjEwMzE4MjUtMGJlMS0xMWYwLWJiYjUtMDZlNDc2YTA3NTY5",
          "email": "<recipient-email>",
          "firstName": "Alex",
          "lastName": "Test"
        }
      ]
    }
  }
}

info

La mayoría de los servidores de correo electrónico permiten el +x después de tu nombre en la dirección de email. Puedes usar esto para probar múltiples destinatarios cuando la plantilla requiere diferentes personas con diferentes direcciones de correo electrónico.