Cree, actualice o combine registros del CRM

Crear, actualizar y upsert representan tres intenciones distintas. Antes de seleccionar una acción, decida si cada envío debe producir un registro nuevo o si los envíos repetidos deben modificar el mismo registro. La elección depende de su proceso y de las reglas de coincidencia que admite el conector.

Crear solicita al CRM que agregue un registro. Puede ser adecuado para una solicitud nueva o una inscripción a un evento. No suponga que esta acción busca duplicados. Los envíos repetidos pueden generar registros separados, salvo que otra regla comprobada lo impida.

Actualizar modifica un registro existente identificado mediante un método compatible con el conector. Una opción habitual es usar el identificador del registro en el CRM. Decida qué debe ocurrir si no se encuentra el destino. No suponga que una actualización creará un registro de reemplazo.

Upsert normalmente busca una coincidencia, actualiza el registro encontrado o crea uno cuando no hay coincidencias. Compruebe las reglas reales del conector. Si coinciden varios registros, el proceso debe detenerse para revisión en lugar de elegir a una persona arbitrariamente.

Prefiera un identificador único y estable que admitan el CRM y el conector. Por ejemplo, un voluntario podría tener el identificador externo ve, o, ele, uno, cero, cuatro, dos. Los nombres no son claves fiables. El correo puede cambiar, compartirse o aparecer en varios registros.

Pruebe con un registro ficticio. Envíe un identificador compatible y un número de teléfono de ejemplo. Después, envíe el mismo identificador con un número diferente. Si busca realizar un upsert, compruebe que se modificó el registro esperado y que no se creó un segundo registro innecesario.

Si una solicitud agota el tiempo de espera, inspeccione el CRM antes de repetirla. La escritura puede haberse completado aunque la respuesta se haya perdido. Conserve juntos el identificador del envío, el del registro y el resultado de la entrega. Evite cambiar la regla de coincidencia mientras investiga esa misma entrega.

Anote la acción, la clave de coincidencia y el comportamiento esperado cuando no haya coincidencias o haya varias. Pruebe esos casos antes de usar datos de clientes. La guía escrita de Klarstig Academy ofrece la misma lista de decisiones.