GUIDA CONFIGURAZIONE Bitrix24 + n8n + DeepAgent
Questa guida spiega come configurare le chiamate automatiche sui nuovi lead di Bitrix24. Ci sono due parti: prima crei il workflow su n8n, poi colleghi Bitrix.
Scritto da Product
Ultimo aggiornamento Circa 2 mesi fa
PARTE 1 - CREARE IL WORKFLOW SU N8N
Step 1 - Crea un nuovo workflow
Apri n8n e crea un nuovo workflow chiamato "Bitrix → DeepAgent"
Step 2 - Aggiungi il nodo Webhook
Aggiungi un nodo Webhook con queste impostazioni:
HTTP Method: POST
Path: scegli un nome (es. bitrix-lead)
Clicca su "Test URL" o "Production URL" e copia l'URL - ti servirà dopo per Bitrix.
Step 3 - Aggiungi il nodo Code (Normalizza Telefono)
Aggiungi un nodo Code collegato al Webhook con questo codice:
Example// Estrai telefono dal formato Bitrix (è un array)
const fields = $json.data?.FIELDS || $json;
let phoneField = '';
// Bitrix manda il telefono come array
if (fields.PHONE && Array.isArray(fields.PHONE)) {
phoneField = fields.PHONE[0]?.VALUE || '';
} else {
phoneField = fields.PHONE || fields.phone || '';
}
let normalizedPhone = phoneField.toString().trim();
// Rimuovi spazi, trattini, punti e parentesi
normalizedPhone = normalizedPhone.replace(/[\s\-\.\(\)]/g, '');
// Se inizia con 00, sostituisci con +
if (normalizedPhone.startsWith('00')) {
normalizedPhone = '+' + normalizedPhone.substring(2);
}
// Se è un numero italiano senza prefisso
if (normalizedPhone.match(/^3[0-9]{8,9}$/)) {
normalizedPhone = '+39' + normalizedPhone;
}
// Se inizia con 39 senza +
if (normalizedPhone.startsWith('39') && !normalizedPhone.startsWith('+')) {
normalizedPhone = '+' + normalizedPhone;
}
// Validazione base
const isValid = normalizedPhone.startsWith('+') && normalizedPhone.length >= 11;
// Estrai nome
const nome = fields.NAME || fields.name || 'Cliente';
return {
json: {
phone_normalized: normalizedPhone,
phone_valid: isValid,
nome: nome,
original_phone: phoneField
}
};Step 4 - Aggiungi il nodo IF (Valida Numero)
Aggiungi un nodo IF per controllare se il numero è valido:
Condizione: {{ $json.phone_valid }} è uguale a true
Step 5 - Aggiungi il nodo HTTP Request (Chiamata DeepAgent)
Collega l'output TRUE del nodo IF a un nodo HTTP Request con queste impostazioni:
Method: POST
URL: https://deepapi.deepagent.app/functions/v1/deepagent/start-outbound-call
Authentication: None
Headers:
Body (JSON):
Example{
"phoneNumberId": "[IL TUO PHONE NUMBER ID]",
"agentId": "[IL TUO AGENT ID]",
"phoneNumber": "{{ $json.phone_normalized }}",
"metadata": {
"dynamicVariables": {
"nome": "{{ $json.nome }}"
}
},
"skipTimeCheck": true
}Step 6 - Attiva il Workflow
Clicca su Active in alto a destra per attivare il workflow. Copia l'URL di Production del webhook.
PARTE 2 - CONFIGURARE BITRIX24
Step 1 - Accedi alle Impostazioni Webhook
Vai in: CRM → Impostazioni → Integrazione → REST API → Webhook in uscita
(Oppure cerca "webhook" nella barra di ricerca di Bitrix)
Step 2 - Crea Nuovo Webhook
Clicca su "Aggiungi webhook in uscita" e compila così:
• Nome: DeepAgent - Nuovi Lead
• URL gestore: [INCOLLA QUI L'URL PRODUCTION DEL WEBHOOK N8N]
• Tipo di evento: Seleziona ONCRMLEADADD (creazione nuovo lead CRM)
Step 3 - Salva e Testa
1. Salva il webhook
2. Crea un lead di prova in Bitrix con un numero di telefono valido
3. Entro pochi secondi dovresti ricevere la chiamata automatica
DATI DA INSERIRE
Ti servono questi dati da DeepAgent (te li forniamo noi):