El teu sistema mana, el nostre respon
No hi ha connector per mantenir ni calendari nostre per esperar. El teu sistema crea leads, demana comparatives i llança altes contra la nostra API, i rep un esdeveniment signat cada cop que canvia alguna cosa. El que construeixis és teu.
Què vol dir «API friendly»
Tres coses concretes. Que tot el que fa una persona al CRM es pot fer per API des del teu sistema, amb les mateixes regles. Que no has de preguntar: quan alguna cosa canvia, t'ho diem nosaltres amb un webhook. I que l'API és un contracte: documentada, versionada, i sense camps que apareguin o desapareguin sense avís.
El resultat és que un canal amb un CRM propi, un web propi o un ERP no ha de canviar d'eina per treballar amb nosaltres.
Què pot fer el teu sistema
| Acció | Què obtens |
|---|---|
| Crear un lead | L'oportunitat neix al CRM amb el teu canal d'entrada i, si ho indiques, assignada a un comercial. |
| Demanar una comparativa | Amb una factura o un CUPS. Retorna les tarifes del catàleg del canal contra l'actual, amb l'estalvi descompost. |
| Llançar una alta | Amb la comparativa acceptada o directament. Entra en tramitació i des d'allà t'arriben els esdeveniments. |
| Consultar l'estat | D'un lead, d'un expedient o de la teva cartera, amb el motiu si alguna cosa està aturada. |
| Consultar liquidacions | El meritat, el liquidat i el pendent del canal. |
Algunes d'aquestes capacitats entren per fases. A la demo et diem quines estan obertes avui i amb quins límits; no publiquem aquí una llista que caduqui.
Webhooks: t'avisem nosaltres
Cada canvi rellevant —lead creat, comparativa llesta, proposta acceptada, alta enviada, alta rebutjada amb el seu motiu, contracte activat, liquidació tancada— dispara un esdeveniment a l'URL que hagis registrat.
- Signats. Cada esdeveniment porta una signatura amb el secret del teu canal; comproves que ve de nosaltres i que no s'ha tocat pel camí.
- Reintents. Si el teu endpoint no respon, reintentem amb espera creixent durant hores. Res no es perd per un desplegament teu a mala hora.
- I si continua caient, una persona. L'esdeveniment no es descarta en silenci: l'oportunitat apareix com a tasca per a algú del teu equip, amb l'esdeveniment pendent adjunt.
- Idempotents. Cada esdeveniment té un identificador; si el reps dues vegades, saps que és el mateix.
Autenticació i entorns
- Claus per canal, una de producció i una de proves. S'ensenyen una sola vegada en crear-les; després només se'n veuen els últims caràcters.
- Amb caducitat. Les claus expiren i es roten des del mateix CRM, sense demanar-nos-ho.
- Entorn de proves amb dades inventades, perquè el teu equip construeixi sense tocar clients reals.
- Àmbit per canal. Una clau només veu les dades del canal que l'ha creat. No hi ha cap clau que ho vegi tot.
El que no surt mai per l'API
L'API retorna una projecció: un conjunt de camps declarat un a un, que és el mateix que llegeixen el bot de missatgeria i l'agent de veu. Es declara què surt, no què s'amaga, i per això un camp nou a la base de dades no apareix a cap integració fins que algú l'afegeix a propòsit.
Fora, per disseny: el marge del canal, les comissions d'altres canals i l'IBAN. Ni amb la clau de producció, ni amb la de proves, ni demanant-ho.
Com començar
Demana la clau de proves des del CRM del teu canal i registra l'URL del teu webhook.
Crea un lead i demana una comparativa amb un CUPS de prova. Veuràs arribar els dos primers esdeveniments.
Llança una alta i segueix l'expedient fins al contracte actiu, amb els seus esdeveniments. Quan ho tinguis, canvies a la clau de producció.
FAQ
Teniu documentació pública de l'API?
La documentació es lliura amb la clau de proves, juntament amb l'entorn de proves i una col·lecció d'exemples. No està publicada en obert perquè part de l'API entra per fases i preferim que el que llegeixis sigui el que pots fer servir avui.
Puc connectar el meu CRM sense programar?
Per a HubSpot, Salesforce i Pipedrive hi ha un mirall de l'expedient que no requereix desenvolupament per part teva: l'expedient apareix al teu CRM amb els mateixos camps que retorna l'API. L'API és per a quan vols alguna cosa a mida.
Què passa si canvieu l'API?
Està versionada. Els canvis que trenquen alguna cosa van en una versió nova i l'anterior continua funcionant un temps anunciat. Afegir un camp mai no trenca res, perquè el teu sistema només llegeix els que coneix.