¿Cómo puedo usar la API de Salesflare con "Webhooks by Zapier"?

A veces quieres hacer algo específico con la API de Salesflare y los zaps prediseñados no son suficientes. Para esos casos, existe «Webhooks by Zapier».

Aquí tienes la página oficial sobre esto en el sitio web de Zapier.

Webhooks by Zapier se puede usar para hacer cualquier cosa en la API pública de Salesflare. Te explicaré cómo.

---

0. Antes de empezar: ¿qué es una API? 🙄

Una API es una interfaz de programación de aplicaciones.

Es la forma en que un software se comunica con otro software. Las apps se comunican con los servidores. Los servidores se comunican entre sí.

Es la boca Y los oídos del software.

Vamos:

1. Usa Webhooks by Zapier

Fácil. Solo busca «webhooks» o «zapier». Selecciona. Siguiente. 😎

2. Elige el método adecuado

Hay cuatro métodos básicos que puedes usar en la API REST de Salesflare:

• GET: obtener objetos

• PUT: introducir información en objetos 

• POST: crear objetos nuevos

• DELETE: eliminar objetos

DELETE no está disponible en Webhooks by Zapier. Sin embargo, sí es posible hacer una solicitud personalizada. Como escribe Zapier, es «muy flexible, pero implacable».

3. Configura la solicitud

Déjame explicarte rápidamente los campos.
​
​URL: Especifica el endpoint que quieres usar. 🔗

Algunos ejemplos:

https://api.salesflare.com/messages (POST)
https://api.salesflare.com/accounts (GET, POST)
https://api.salesflare.com/contacts/{contact_id} (GET, PUT)

Solo tienes que consultar las posibilidades en la documentación.

Si arriba aparece algo como {contact_id}, debes especificar un id. Esto se puede rellenar con una etiqueta de combinación de Zapier.

Tipo de carga útil: Elige "Json". ¡Eso es todo! ✋

Datos: Aquí es donde ocurre la magia. 

Aquí puedes especificar los datos que quieres pasar a Salesflare al hacer un PUT o POST.

Los datos siempre se presentan en forma de claves y valores. La clave es el nombre del campo/atributo y el valor es el contenido.

Estos son algunos ejemplos de lo que puedes hacer en una cuenta (clave : valor) :

• nombre : Salesflare

• dominio : salesflare.com

• phone_numbers : [{"type":"work","number":"+32499217782"},{"type":"work","number":"+32496725080"}]

Una vez más, todas las posibilidades están en la documentación.

Cosas como los arrays de números de teléfono no están bien descritas allí. Si quieres usar esto, puedes consultar las llamadas de la app en la consola de desarrollador. O simplemente háblanos por el chat.

Para pasar campos personalizados, usa "custom__fieldname" (dos guiones bajos entre custom y fieldname). Los nombres de los campos se transforman así:

• todo se escribe en minúsculas

• los espacios se convierten en guiones bajos

• los caracteres especiales y los emojis no se eliminan 😎

Otra particularidad: al hacer un PUT y pasar un array de objetos, debes usar la siguiente combinación adicional de clave:valor en cada objeto "_dirty":"true". Por ejemplo:

• phone_numbers : [{"type":"work","number":"+32499217782","_dirty":"true"},{"type":"work","number":"+32496725080","_dirty":"true"}]

Sí, magia 😏

Envolver la solicitud en un array: Normalmente, esto debe ser "no". A menos que estés creando una cuenta a partir de un contacto; en ese caso, la API espera un array de contactos.

Archivo: No tocar 🛑

Desaplanar: ¡Sí! 👍 Esto es útil si quieres pasar cosas como campos personalizados.

Autenticación básica: No se aplica aquí. La autenticación se hace en los encabezados de abajo. 👇

Encabezados: Aquí es donde te autenticas con la API de Salesflare.

Naturalmente, debes asegurarte de que Salesflare sabe que eres tú. Para ello necesitas una clave API. 🔑 Es tu contraseña secreta. Puedes crear una clave API desde Ajustes > clave API.

Solo tienes que pasarla de la siguiente manera (clave : valor) :

Authorization : Bearer {APIKEY}

Aquí tienes un ejemplo completo:

4. ¡Hora de hacer pruebas!

¿Ha funcionado? ¿O recibes un error? 😜

Avísanos por el chat si el error es incomprensible. Lo revisaremos contigo.

¡Diviértete automatizando! 🤖🎉