Astrify FlowsAstrify FlowsMeta Business Partner

Pour les développeurs

API REST et webhooks pour intégrer Astrify

Créez des leads, envoyez des messages, modifiez les boards et déclenchez des Workflows depuis votre système, recevez des données par webhook et appelez n'importe quelle API au milieu d'un flux, avec des clés par portée et une documentation OpenAPI.

  • OpenAPI 3.1 et Postman
  • Clés avec portée
  • À partir de Growth

Terminal

curl -X POST https://api2.astrify.com.br/v1/leads \
  -H "Authorization: Bearer astrify_7f3k…" \
  -H "Content-Type: application/json" \
  -d '{
    "nome": "Paula Mendes",
    "telefone": "+5511955550000",
    "email": "paula@email.com"
  }'

201 Created

{
  "id": "ld_8c21…",
  "nome": "Paula Mendes",
  "etapa": "Novo lead",
  "funil": "Vendas"
}
  • 128

    routes dans l'API, des leads et messages aux boards et propositions

  • 16

    ressources avec portée de lecture ou d'écriture par clé

  • 120

    requêtes par minute pour chaque clé

  • 20

    clés actives par entreprise, chacune avec son journal d'utilisation

API REST

Ce que fait l'API

Choisissez la ressource et voyez quelques routes.

Leads et pipeline

Créez et mettez à jour des leads, fusionnez les doublons, importez en lot et enregistrez activités et notes. Le pipeline et les étapes sont lus par l'API.

  • Créer, lister, mettre à jour, supprimer et fusionner des leads
  • Import en lot et détection des doublons
  • Activités, notes, participants et articles du deal
  • Pipelines, étapes, origines et motifs de perte (lecture)

api2.astrify.com.br/v1

  • POST/leads
  • GET/leads
  • PATCH/leads/{lead_id}
  • POST/leads/importar-lote
  • GET/funis/{funil_id}/etapas

Clés d'API

Chaque intégration avec votre clé

Les clés sont créées dans Paramètres › API ouverte et envoyées dans l'en-tête Authorization. Elles agissent au nom de leur créateur et cessent de fonctionner si cette personne est désactivée.

  • 01

    Portée par ressource

    Chaque clé ne lit ou n'écrit que ce que vous cochez : leads, contacts, boards, messages et le reste.

  • 02

    Validité et adresses IP

    Validité de 1 à 730 jours et liste de 20 adresses IP autorisées maximum.

  • 03

    Affichée une seule fois

    La clé n'apparaît qu'à la création ; Astrify n'en conserve qu'une signature.

  • 04

    Renouveler et révoquer

    Renouvelez la clé sans arrêter l'intégration et révoquez-la immédiatement, avec le journal d'utilisation de chacune.

Webhook entrant

Votre système prévient, le Workflow agit

Le déclencheur « Recevoir un webhook » donne au Workflow sa propre adresse. Envoyez le JSON de votre système, de n8n, de Make ou de Zapier, retrouvez le lead par e-mail ou téléphone et suivez le flux. En mode écoute, Astrify affiche le premier envoi pour que vous mappiez les champs avant l'activation.

  • GET, POST, PUT et PATCH, jusqu'à 256 Ko
  • Mode écoute de 2 minutes pour voir l'envoi réel
  • 50 derniers événements conservés pour chaque déclencheur
  • Jusqu'à 120 appels par minute pour chaque adresse

POST /api/webhooks/workflow/{token}

{
  "evento": "pagamento_aprovado",
  "cliente": {
    "nome": "João Prado",
    "email": "joao@pradoalimentos.com.br"
  },
  "valor": 1290.00
}

D'Astrify vers votre système

Deux chemins, selon ce que vous avez besoin de savoir.

Dans le Workflow

Requête HTTP et Déclencher un webhook

N'importe quel déclencheur (changement d'étape du lead, proposition acceptée, commande livrée) peut appeler votre système au milieu du flux et utiliser la réponse dans les blocs suivants.

  • GET, POST, PUT, PATCH et DELETE avec en-têtes et corps JSON
  • Variables du lead dans l'URL et dans le corps
  • Réponse enregistrée dans une variable pour le Si/Sinon
  • Attendre la réponse ou envoyer et continuer

Webhooks sortants

Événements de l'e-mail marketing

Enregistrez jusqu'à 10 adresses dans Paramètres › Webhooks et recevez chaque événement signé, avec de nouvelles tentatives et l'historique des envois.

  • email.opened
  • email.clicked
  • email.replied
  • email.unsubscribed
  • email.bounced
  • email.complaint
  • email.list_joined
  • Signature HMAC-SHA256 dans l'en-tête X-Astrify-Signature
  • Nouvelles tentatives après 1 min, 5 min, 30 min, 2 h et 6 h
  • Historique avec renvoi et bouton de test

Documentation

OpenAPI, Postman et le guide dans la plateforme

La spécification OpenAPI 3.1 et la collection Postman sont ouvertes sur api2.astrify.com.br/v1/openapi.json et /v1/postman.json. Dans la plateforme, la page de documentation explique l'authentification, les portées, les erreurs et des exemples pour chaque route.

Outils

n8n, Make et Zapier sans connecteur payant

Utilisez le nœud de requête HTTP de ces outils avec votre clé, et leur webhook dans le bloc « Déclencher un webhook ».

  • n8n
  • Make
  • Zapier
Les jetons des canaux et les secrets des webhooks sont chiffrés, les adresses internes sont bloquées dans les requêtes sortant de la plateforme et l'API respecte les permissions du rôle de la personne qui a créé la clé.

Forfaits

L'API dans chaque forfait

L'API REST et les clés sont disponibles à partir de Growth. Le déclencheur « Recevoir un webhook » et les blocs de requête sont inclus dans tous les forfaits, au sein des Workflows.

ForfaitPar moisAPI RESTRecevoir un webhook et HTTP dans le Workflow
Starter FreeGratuit—Oui
LiteR$ 197,90—Oui
GrowthR$ 397,90OuiOui
ProR$ 797,90OuiOui
ScaleR$ 1 497,90OuiOui

Par mois, en reais brésiliens (BRL) ; en annuel, vous payez 10 mois et profitez de 12. Voir tous les forfaits

Poursuivez ici

Questions fréquentes

Ce que les développeurs demandent avant d'intégrer.

Oui, à partir de Growth : une API REST avec environ 128 routes pour les leads, contacts, pipelines, étiquettes, produits, propositions, messages WhatsApp, conversations, Workflows, campagnes, e-mail, équipes, tâches, boards et notifications.
Avec une clé créée dans Paramètres › API ouverte, envoyée dans l'en-tête Authorization: Bearer. Chaque clé a une portée par ressource (lecture ou écriture), une validité de 1 à 730 jours, une liste d'IP facultative et un journal d'utilisation. Elle n'apparaît qu'une seule fois et peut être renouvelée ou révoquée.
120 requêtes par minute pour chaque clé, avec une réponse 429 et le temps d'attente en cas de dépassement. Chaque entreprise peut avoir jusqu'à 20 clés actives.
Via la route POST /v1/leads de l'API, ou via le déclencheur « Recevoir un webhook » d'un Workflow, qui donne une adresse dédiée pour que votre système, n8n, Make ou Zapier envoient les données. L'ancien webhook de leads avec clé x-api-key n'existe plus.
Les webhooks sortants envoient les événements de l'e-mail marketing (ouverture, clic, réponse, désabonnement, rebond, signalement et entrée dans la liste), signés avec HMAC-SHA256 et avec de nouvelles tentatives. Pour prévenir votre système des changements dans le pipeline, les propositions ou les commandes, utilisez le bloc « Déclencher un webhook » ou « Requête HTTP » dans un Workflow.
La spécification OpenAPI 3.1 et la collection Postman sont ouvertes sur api2.astrify.com.br/v1/openapi.json et /v1/postman.json, et la plateforme dispose d'une page de documentation avec authentification, portées, erreurs et exemples.
Astrify Flows

AAstrifyen conversationaveclesystèmede lavotreentreprise.

Testez les Workflows avec webhook sur le forfait gratuit et débloquez l'API à partir de Growth.