Desarrolladores · Zapier + Pipedrive

Envíe referidos a Thurgood desde Pipedrive

Unos 10 minutos, una sola vez. Después, cuando marque un trato como referido a Thurgood, de la misma manera en que ya marca los referidos a cualquier otra persona, los datos del cliente nos llegan 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

Marque los referidos como ya lo hace

Haga lo que su equipo hace hoy cuando un prospecto se refiere a otro despacho: una etapa, un campo "Referido a" o una etiqueta. Luego, en Pipedrive, vaya a Deals → Filters → New filter, establezca la condición que significa "referido a Thurgood" y guárdelo.

Paso 4

Cree el Zap

01
Cree un Zap
En Zapier, cree un nuevo Zap.
02
Pipedrive → Deal Matching Filter
Conecte su cuenta de Pipedrive cuando se le solicite y elija el filtro del paso 3.
03
Thurgood → Send Referral
Conéctelo con su clave API de Thurgood.

Paso 5

Mapear los campos

Campo de Thurgood	Asignar desde Pipedrive
ID del registro	ID del deal (obligatorio)
Nombre	Título del deal (obligatorio). Este se convierte en el nombre del cliente.
Correo electrónico, teléfono	Los campos de correo electrónico y teléfono de su cliente en el deal, si los tiene
Estado, empresa	Dónde trabajaba el cliente y su empleador
Resumen inicial	Su resumen de admisión. Se usa para iniciar el CaseFile del cliente.
Motivo indicado por el empleador, motivo creído	Los campos de sus preguntas de admisión
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	Déjelo en blanco. Su filtro de Pipedrive ya selecciona los deals referidos.

Deje en blanco cualquier campo que no registre. Pipedrive titula un nuevo deal con el nombre de su organización cuando hay una asignada, así que si ahí pone el empleador, cambie el título del deal por el nombre del cliente.

Paso 6

Probar y activar

Las pruebas envían un referido real: al hacer clic en Test step, Zapier envía el deal de muestra a Thurgood. Elija un deal que realmente nos esté refiriendo, 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 o moverlo entre etapas después no creará un duplicado.
Los casos que ya coinciden con su filtro cuando activa el Zap no se envían. Solo se envían los casos que usted marque a partir de ese momento.
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.