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.
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.
| Forfait | Par mois | API REST | Recevoir un webhook et HTTP dans le Workflow |
|---|---|---|---|
| Starter Free | Gratuit | — | Oui |
| Lite | R$ 197,90 | — | Oui |
| Growth | R$ 397,90 | Oui | Oui |
| Pro | R$ 797,90 | Oui | Oui |
| Scale | R$ 1 497,90 | Oui | Oui |
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.

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
























