safina

n8n nodes for Safina, the AI phone assistant: read calls and summaries, manage contacts, and start workflows when a call ends.

Package Information

Released: this month
Downloads: 0 weekly / 0 monthly
Latest Version: 0.1.0
Author: SK Thinking Ltd

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:

  1. Open the Safina app.
  2. Go to Profile > API keys.
  3. Create a key. Select the scope Read and write if you want to create or change contacts. A Read key can only read.
  4. Copy the key (safina_api_…). Safina shows it only once.

Add the credential in n8n:

  1. In n8n, create a credential of the type Safina API.
  2. Paste the key into API Key.
  3. Keep the default API URL (https://api.backend.safina.ai).
  4. 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.

Discussion