Desarrolladores · Zapier + Clio

Enviar referidos a Thurgood desde Clio

Unos 10 minutos, una sola vez. Después, cuando marque un expediente como referido a Thurgood, los datos del cliente llegan a nosotros automáticamente y se inicia su CaseFile. Thurgood nunca envía correos electrónicos al cliente. Necesita una cuenta de Zapier (una gratuita funciona) y su clave de API de Thurgood.

Agregar Thurgood a Zapier

Paso 1

Agregue la aplicación de Thurgood a Zapier

Abra este enlace mientras tiene sesión iniciada en Zapier y acepte la invitación: agregar Thurgood a Zapier.

Paso 2

Obtenga su clave de API

Cada bufete tiene su propia clave, emitida por Thurgood. Comienza con tgk_. Si no tiene una, envíe un correo electrónico a caseworker@askthurgood.com con el nombre de su bufete. Thurgood solo guarda una huella digital de la clave, así que guárdela en un lugar seguro; si se pierde, la revocamos y emitimos una nueva.

Paso 3

Marcar referidos en Clio

Una vez, agregue un área de práctica para los referidos en Clio (Configuración → Áreas de práctica), por ejemplo "Referido a Thurgood". Cuando refiera a un cliente a Thurgood, abra el expediente en esa área de práctica.

Paso 4

Cree el Zap

01
Cree un Zap
En Zapier, cree un nuevo Zap.
02
Clio → Nuevo caso
Conecte su cuenta de Clio cuando se le solicite. Se ejecuta con cada expediente nuevo, por lo que la configuración "Enviar solo cuando" del paso 5 envía únicamente los expedientes de su área de práctica de referidos.
03
Thurgood → Send Referral
Conéctelo con su clave API de Thurgood.

Paso 5

Mapear los campos

Campo de Thurgood	Asignar desde Clio
ID del registro	El ID del caso (obligatorio)
Nombre	El nombre del cliente del caso (obligatorio)
Correo electrónico, teléfono	El correo electrónico y el teléfono del cliente, si figuran en el caso
Estado	El estado donde trabajó el cliente, si lo registra
Resumen inicial	La descripción del caso
Empresa	El empleador del cliente, si lo registra
Motivo indicado por el empleador, motivo creído	Los campos de sus preguntas de admisión, si los tiene
Fechas de empleo, por hora o por salario	Sus campos de fechas y de pago
Documentos o enlaces, puesto de trabajo, notas	Cualquier otra información que desee que Thurgood tenga
Enviar solo cuando este campo…	El área de práctica del caso
…es igual a	Referido a Thurgood (el valor que usa para los referidos; separe varios con comas)

Deje en blanco cualquier campo que no registre. "Enviar solo cuando" es lo que excluye los otros expedientes: cualquier expediente que no coincida se omite y no se envía nada. Está integrado en el paso de Thurgood, por lo que el Zap tiene dos pasos y funciona en el plan gratuito de Zapier.

Paso 6

Probar y activar

Las pruebas envían un referido real: al hacer clic en Probar paso, Zapier envía el expediente de muestra a Thurgood. Elija un expediente que realmente esté refiriendo a nosotros, o omita la prueba. Luego active el Zap.

Qué sucede después

Después de activar el Zap

Thurgood crea el registro del cliente, vinculado a su bufete, e inicia su CaseFile a partir de la admisión que envió.
No se envía ningún correo electrónico al cliente ni a su bufete. Una vez activado el Zap, no necesita enviar referidos por correo electrónico a Thurgood.
Los abogados de su bufete pueden ver la referencia y el formulario de ingreso que envió, en el perfil del cliente.
Cada caso se envía una sola vez, por lo que editarlo después no creará un duplicado.
Si el correo electrónico del cliente ya pertenece a un cliente de Thurgood, ese cliente no se modifica.

Preguntas: caseworker@askthurgood.com

Referencia de la API

La API detrás del Zap

No necesita esto para usar Zapier. Está aquí para sus desarrolladores, o si prefiere enviar referencias desde su propio sistema.

Autenticación

Envíe su clave en el X-Api-Key encabezado en cada solicitud. Authorization: Bearer <key> también se acepta en POST, y un api_key campo para remitentes que no pueden configurar encabezados. Use https://askthurgood.com, no www.: una redirección eliminaría el cuerpo de la solicitud.

Verificar una clave

GET https://askthurgood.com/api/thurgood/referrals/me
X-Api-Key: tgk_your_key_here

200 {"status": true, "lawfirm": "Your Firm Name"}
401 {"status": false, "error": "Invalid API key"}

Enviar una referencia

POST https://askthurgood.com/api/thurgood/referrals
X-Api-Key: tgk_your_key_here
Content-Type: application/json

{
  "external_id": "4821",
  "name": "Jane Doe",
  "email": "jane@example.com",
  "state": "CA",
  "initial_summary": "I was fired two weeks after reporting unpaid overtime..."
}

Se aceptan campos en JSON o en formulario. Los campos que no aparecen a continuación se ignoran.

Campo	Obligatorio	Descripción
external_id	Recomendado	Su número de identificación del registro (por ejemplo, el id del negocio en Pipedrive). Cada id se acepta una vez por bufete. `pipedrive_deal_id` también funciona.
name	Sí	Nombre completo del cliente (o envíe `first_name` + `last_name`).
email	No	Correo electrónico del cliente. Si se envía, debe ser una dirección válida.
phone	No	Teléfono del cliente.
state	No	Estado de EE. UU. donde trabajó el cliente — `CA` o `California`.
company	No	Empleador.
initial_summary	No	La versión del cliente sobre lo que sucedió. Se usa para iniciar su CaseFile.
employer_reason	No	Lo que el empleador dijo que fue la razón del despido o la separación.
believed_reason	No	Por qué el cliente cree que realmente fue despedido o separado.
fechas_de_empleo	No	Fechas de empleo.
pago	No	Por hora o salario fijo.
drive_links	No	Enlaces a cualquier documento del cliente (Google Drive, Dropbox, etc.).
job_title	No	Puesto de trabajo.
notes	No	Cualquier otra información para Thurgood.

Respuesta	Cuerpo	Significado
202	`{"status": true, "referral_id": 123}`	Aceptada. El procesamiento termina en unos minutos.
200	`{"status": true, "duplicate": true, "referral_id": 123}`	Esta `external_id` ya fue enviada; no se creó nada nuevo.
401	`{"status": false, "error": "Invalid API key"}`	Clave faltante, incorrecta o revocada.
422	`{"status": false, "error": "A name is required"}`	Falta el nombre, o el correo electrónico no es una dirección válida.
429		Más de 200 solicitudes por minuto.