Pour commencer
Synchronisation des donnees
Synchronisation CRM (incrementale)
Recuperez uniquement les nouvelles activites depuis votre derniere synchronisation — pas besoin de tout re-telecharger.
GET /v2/api/conversations?allo_number=%2B14155550100&last_activity_since=2026-04-20T10:00:00Z
Stockez le timestamp last_activity de la reponse et utilisez-le comme last_activity_since lors de la prochaine synchronisation.
Exporter tous les appels sortants de ce trimestre
Parcourez tous les resultats page par page :
POST /v2/api/conversations/items/search
{
"date": { "from": "2026-01-01", "to": "2026-03-31" },
"direction": "OUTBOUND",
"type": "CALL",
"page": 1,
"size": 100
}
Incrementez page jusqu'a ce que pagination.has_more soit false.
Recherche dans les conversations
Trouver les appels ou les clients ont mentionne des problemes de facturation
Recherche par mots-cles dans toutes les transcriptions et resumes d'appels :
POST /v2/api/conversations/items/search
{
"search": "billing issues",
"type": "CALL",
"sort": "RELEVANCE"
}
Les termes de recherche sont combines avec AND et utilisent la correspondance par prefixe — "bill" correspond a "billing", "billed", etc.
Rechercher ce que nous avons discute des remboursements avec un contact
POST /v2/api/conversations/items/search
{
"contact_number": "+14155551234",
"search": "refunds",
"sort": "RELEVANCE"
}
Afficher toutes les interactions avec un contact
POST /v2/api/conversations/items/search
{
"contact_number": "+14155551234"
}
Retourne la timeline complete des appels et SMS avec un contact, incluant les contacts associes, l'entreprise et les deals.
Obtenir le contexte complet d'un appel specifique
GET /v2/api/conversations/items/cll-abc123?extend=transcript
Retourne l'appel avec le resume, les tags, l'URL d'enregistrement et la transcription complete. transcript est la seule valeur extend supportee.
Combien d'appels ont ete manques la semaine derniere ?
Utilisez l'endpoint de recherche avec size=1 pour obtenir uniquement le total :
POST /v2/api/conversations/items/search
{
"date": { "from": "2026-04-14", "to": "2026-04-21" },
"result": "VOICEMAIL",
"type": "CALL",
"size": 1
}
Lisez pagination.total_count dans la reponse — pas besoin de recuperer tous les resultats.
Cela compte les appels entrants tombes sur la messagerie. Les appels sortants qui ont atteint le repondeur du contact gardent result: "ANSWERED" — reperez-les avec le champ detected_outbound_voicemail present sur chaque element.
Actions
Taguer un appel puis trouver tous les appels avec ce tag
# 1. Taguer l'appel
POST /v2/api/conversations/items/cll-abc123/tags
{ "tags": ["qualified"] }
# 2. Trouver tous les appels avec ce tag
POST /v2/api/conversations/items/search
{ "tags": ["qualified"] }
Ajouter un tag qui existe deja retourne 409 TAG_ALREADY_EXISTS — aucun doublon n'est cree.
Marquer une conversation comme lue
PUT /v2/api/conversations/%2B14155551234/action
{ "action": "READ" }
Pour cibler un numero Allo specifique :
PUT /v2/api/conversations/%2B14155551234/action
{ "action": "READ", "allo_number": "+14155550100" }
Toutes les actions sont idempotentes — appeler READ sur une conversation deja lue est sans effet.
Archiver une conversation
PUT /v2/api/conversations/%2B14155551234/action
{ "action": "ARCHIVE" }
Cela archive le contact et marque tous les elements comme lus.
Envoyer un SMS de suivi
L'envoi de SMS utilise l'endpoint de l'API v1 :
POST /v1/api/sms
{
"to": "+14155551234",
"allo_number": "+14155550100",
"content": "Thanks for your call! Let me know if you have any other questions."
}
Necessite le scope SMS_SEND. Voir Envoyer un SMS pour les details.
Analytique et reporting
Quelle est ma performance en appels a froid cette semaine par rapport a la semaine derniere ?
# 1. Obtenir le funnel sortant avec comparaison semaine par semaine
POST /v2/api/analytics/outbound
{
"date": { "from": "2026-04-14", "to": "2026-04-21" },
"compare_date": { "from": "2026-04-07", "to": "2026-04-14" },
"tags": ["meeting_booked"],
"granularity": "DAY"
}
La reponse inclut le funnel complet (appels, connectes, conversations, conversions) avec l'evolution par rapport a la semaine precedente, la serie temporelle quotidienne, la heatmap et le classement.
# 2. Explorer les appels convertis (utiliser extend=items)
POST /v2/api/analytics/outbound
{
"date": { "from": "2026-04-14", "to": "2026-04-21" },
"tags": ["meeting_booked"],
"granularity": "DAY",
"extend": "items",
"stage": "CONVERSION"
}
# 3. Obtenir les details complets (resume, transcription, tags)
POST /v2/api/conversations/items/batch
{ "ids": ["cll-abc123", "cll-def456"] }
Obtenir la performance de l'equipe du mois dernier
POST /v2/api/analytics/overview
{
"date": { "from": "2026-03-01", "to": "2026-03-31" },
"compare_date": { "from": "2026-02-01", "to": "2026-02-28" }
}
Retourne le total des appels, le temps de conversation, le taux de reponse et le detail par utilisateur — le tout avec l'evolution par rapport a la periode de comparaison.
Comparer la performance de deux commerciaux
POST /v2/api/analytics/overview
{
"date": { "from": "2026-04-01", "to": "2026-04-21" },
"compare_date": { "from": "2026-03-01", "to": "2026-03-31" },
"user_ids": ["usr-abc123", "usr-def456"]
}
Le detail dans la reponse inclut les deux utilisateurs avec leurs metriques individuelles et l'evolution par rapport a la periode de comparaison.
Equipe et configuration
Resoudre le nom d'un membre de l'equipe pour filtrer les conversations
# 1. Trouver l'utilisateur
GET /v2/api/users
# 2. Utiliser son ID pour filtrer
POST /v2/api/conversations/items/search
{ "user_id": "usr-abc123", "type": "CALL" }