Package Information
Available Nodes
Documentation generating…
Documentation
@sk-thinking/n8n-nodes-safina
This is an n8n community node package for Safina, the AI phone assistant. It lets you read calls and their summaries, manage contacts, and start a workflow when a call ends.
n8n is a fair-code licensed workflow automation platform.
Installation
Follow the installation guide in the n8n community nodes documentation. The package name is @sk-thinking/n8n-nodes-safina.
Credentials
The nodes use a Safina API key.
Requirements:
- The Safina API is in beta. API keys are in early access: write to info@safina.ai.
- The team needs the Pro plan or higher.
- Only the owner or an admin of the team can create a key.
Create the key:
- Open the Safina app.
- Go to Profile > API keys.
- Create a key. Select the scope Read and write if you want to create or change contacts. A Read key can only read.
- Copy the key (
safina_api_…). Safina shows it only once.
Add the credential in n8n:
- In n8n, create a credential of the type Safina API.
- Paste the key into API Key.
- Keep the default API URL (
https://api.backend.safina.ai). - Click Save. n8n tests the key with
GET /users/me.
The key acts for the person who created it, in one team. A key expires after the time that you selected (30 days, 90 days, 1 year, or never). After that, create a new key and update the credential.
Nodes and operations
Safina
| Resource | Operation | What it does |
|---|---|---|
| Assistant | Get Many | Lists the assistants of the team. |
| Call | Get | Gets one call with its summary, caller, numbers, and duration. |
| Call | Get Many | Lists the calls, newest first. Filters: phone number (at least 4 digits, a part of the number matches), start date, end date, minimum and maximum duration. |
| Contact | Create | Creates a contact. Only the phone number is necessary. Safina returns an error when the number already exists. |
| Contact | Get | Gets the contact with a phone number. When no contact has this number, the node returns no item (it is not an error). |
| Contact | Get Many | Lists or searches the contacts. Filters: search text (name, company, or phone number), in the contact list, blocked. |
| Contact | Update | Changes the fields that you add to a contact. |
You can use the Safina node as a tool of the n8n AI Agent.
Safina Trigger
| Event | When it starts |
|---|---|
| Call Ended | After each call, when the summary is ready. |
When you activate the workflow, the trigger subscribes a webhook in Safina (POST /webhooks). When you deactivate the workflow, it deletes the webhook (DELETE /webhooks/{id}).
The trigger asks Safina for a signing secret and checks the X-Safina-Signature header of each event. It refuses events without a valid signature (HTTP 401). Safina sends an event again when the delivery fails; the trigger starts the workflow only once for each event_id.
A team can have at most 20 webhooks. Each active workflow with a Safina Trigger uses one.
Usage
- Find or create a contact: use Contact: Get with the caller's number. Turn on Always Output Data in the node settings, then use an If node: when the item has no
id, use Contact: Create. - The webhook was deleted in the Safina app: the trigger cannot see this. Deactivate and activate the workflow again; this creates a new webhook.
- Test events: Listen for test event in the editor creates a separate, temporary webhook. Make a test call to your Safina number, then n8n shows the event.
Compatibility
Tested with n8n 2.47.2 (self-hosted, Docker). The package uses n8n nodes API version 1 and has no runtime dependencies.
Resources
License
MIT. Published by SK Thinking Ltd.