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:

Headers:

Header

Valore

Accept

application/json

Content-Type

application/json

X-API-Key

[LA TUA API KEY DEEPAGENT]

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):

Campo

Valore

API Key

da_XXXXXXXX_XXXXXXXX

Agent ID

xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

Phone Number ID

xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx