¿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 ya preparados no son suficientes. Para esas ocasiones, existe "Webhooks by Zapier".

Esta es la página oficial sobre ello 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 allá:

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 nuevos objetos

• DELETE: eliminar objetos

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

3. Configura la solicitud

Voy a explicarte rápidamente los campos.

URL: Especifica el endpoint que quieres utilizar. 🔗

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}, tienes que especificar un id. Puedes rellenarlo con una etiqueta de combinación de Zapier.

Tipo de payload: Selecciona "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

• domain : salesflare.com

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

De nuevo, todas las posibilidades están en la documentación.

La documentación no describe bien cosas como los arrays de números de teléfono. Si quieres utilizar esto, puedes consultar las llamadas de la app en la consola para desarrolladores. O simplemente hablar con nosotros por el chat.

Para pasar campos personalizados, utiliza "custom__fieldname" (dos guiones bajos entre custom y fieldname). Los nombres de los campos se transforman de la siguiente manera:

• todo se convierte en minúsculas

• los espacios se convierten en guiones bajos

• los caracteres especiales y los emojis no se eliminan 😎

Otra especificidad: al hacer un PUT y pasar una matriz 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í, magix 😏

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

Archivo: No tocar 🛑

Desaplanar: ¡Sí! 👍 Esto es práctico si quieres pasar cosas como campos personalizados.

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

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

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

Pásalo simplemente de la siguiente manera (clave : valor) :

Authorization : Bearer {APIKEY}

Este es un ejemplo completo:

4. ¡Hora de probarlo!

¿Funciona correctamente? ¿O recibes un error? 😜

Avísanos a través del chat si el error es incomprensible. Lo revisaremos contigo.

¡Diviértete automatizando! 🤖🎉