v1Recursos/Review Invites/postActualizar un destinatario
Actualizar un destinatario
Corrige el nombre, correo electrónico, teléfono o tipo de contacto de un destinatario. El correo electrónico y el teléfono quedan bloqueados una vez que se ha enviado un mensaje a ese destinatario — cambiar cualquiera de los dos después de un envío devuelve un 409, ya que los acuses de recibo y las respuestas están vinculados a la dirección realmente usada.
post
review-invite:write/api/v1/review-invites/updateCuerpo de la solicitud
recipientIdstringobligatorio
El destinatario a actualizar. Obligatorio.
namestringopcional
Nuevo nombre.
emailstringopcional
Nueva dirección de correo electrónico. Se rechaza con un 409 si ya se le envió un mensaje a este destinatario.
phonestringopcional
Nuevo número de teléfono. Se rechaza con un 409 si ya se le envió un mensaje a este destinatario.
contactTypestring (Customer | Lead | Prospect | Contact)opcional
Nuevo tipo de contacto: Customer, Lead, Prospect o Contact.
Respuesta
dataobjectopcional
idstringopcional
Identificador único del destinatario.
namestringopcional
El nombre del destinatario, o vacío si no se indicó.
emailstringopcional
La dirección de correo electrónico del destinatario, o vacío si no se indicó.
phonestringopcional
El número de teléfono del destinatario, o vacío si no se indicó.
contactTypestringopcional
Uno de: Customer, Lead, Prospect, Contact.
statusstringopcional
Estado de entrega actual de este destinatario.
Errores
400A la solicitud le falta un parámetro obligatorio o es inválida de otra forma.
401La clave de API falta, es inválida, expiró o fue revocada.
403A la clave le falta el permiso requerido, o no está autorizada para este cliente/ubicación.
404El recurso no se encontró, o no pertenece a su agencia.
409La solicitud entra en conflicto con el estado actual del recurso — por ejemplo, cambiar el correo electrónico o el teléfono de un destinatario al que ya se le ha enviado un mensaje, o una invitación de equipo que ya fue aceptada (o que aún no ha sido aceptada).
422A la solicitud le falta un parámetro obligatorio o es inválida de otra forma.
429Demasiadas solicitudes. Reintente tras el número de segundos indicado en el encabezado Retry-After.
post/api/v1/review-invites/update
Su clave de API
Cuerpo de la solicitud*
{
"data": {
"id": "cm_recip_1",
"name": "Jordan Lee",
"email": "jordan@example.com",
"phone": null,
"contactType": "Customer",
"status": "pending"
}
}