v1Recursos/Review Invites/postPrevisualizar o importar contactos del CRM

Previsualizar o importar contactos del CRM

Requiere ReviewGen, acceso a Reseñas, propietario/administrador de agencia sin restricciones y credencial sin restricciones. POST siempre exige review-invite:write. op:preview obtiene contactos actuales del CRM sin guardar; limit vale 500 por defecto y admite 1–5000. mapping opcional solo se aplica a la vista previa y no se guarda. op:import usa las reglas guardadas y el límite del trabajo; rechaza mapping y limit. Puede enviar correo/SMS y consumir Credits, por lo que allowSend:true exige aprobación explícita de esos envíos. HTTP 202 devuelve runId y status:queued, no resultados completados. HTTP 503 con data.status:queue_unknown y runId indica confirmación de cola desconocida: consultar ese trabajo antes de iniciar otro. La vista previa omite registros originales del proveedor y planificación interna.

post/api/v1/review-invites/crm/{id}/import
review-invite:write
Parámetros de consulta
idstringobligatorio
Cuerpo de la solicitud
opstring (preview | import)opcional
mappingobjectopcional
sourceFieldstringobligatorio
rulesarray of objectobligatorio
valuestringobligatorio
locationIdstringobligatorio
fallbackLocationIdstringobligatorio
limitintegeropcional
allowSendbooleanopcional
Respuesta
dataobjectopcional
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.
409El registro cambió, el envío requiere aprobación o la operación entra en conflicto con el estado actual.
429Demasiadas solicitudes. Reintente tras el número de segundos indicado en el encabezado Retry-After.
503No se pudo completar la operación de invitación. Una cola del CRM no confirmada conserva runId; consultarlo antes de reintentar.
post/api/v1/review-invites/crm/{id}/import
Su clave de API
id *
Cuerpo de la solicitud
{}

Guías que usan este recurso