ever-just/agentskills / skills/everjust-telephony
everjust-telephony
VerifiedEVERJUST Telephony — Agent Skill
Operate the voice / call-logging stack of an everjust.app tenant as a running agent:
find a contact's or lead's call history, log or place a call, read a recording or a
voicemail transcription, send an SMS tied to a call, and — most importantly — figure out
which provider this particular tenant is on before you touch anything. You reach every
model through the tenant's Odoo MCP / ORM (search, get, count, find, create,
update, call, describe_model; raw env[...] shown where clearer) — see
[[everjust-agent-mcp]] for opening the session against the right tenant DB, and
[[everjust-platform]] for the non-standard invariants (one-DB-per-tenant, sudo/ACL, secrets).
The three addons in scope:
voip_oca— "Phone Engine" (OCA/Dixmit, AGPL). The base:voip.pbxconfig,voip.callsession rows, a browser softphone widget, and hooks onres.users/mail.activity. Installed on every tenant. By itself it is a generic SIP/WebRTC shell with a demo PBX.everjust_ringover— EVERJUST's Ringover integration. Depends onvoip_ocaandcrm. Patches the voip_oca softphone to dial through the Ringover Web SDK (browser WebRTC), syncs completed calls from Ringover's REST API intoringover.call, receives Ringover webhooks, and can trigger a server-side callback. This is where call history actually lands.everjust_phone— EVERJUST's Twilio stack. Independent of voip_oca/Ringover. Its own models (everjust.phone.call,everjust.phone.sms), its own Twilio Voice SDK softphone, its own webhooks. A different provider path.
Provider swap, not a stack.
everjust_ringoverandeverjust_phoneare alternative voice backends. A tenant is on Ringover or Twilio (or neither — just the voip_oca shell). They do not share tables. Read the provider first (Recipe 0); pick the right model.
When to use this skill
- Look up call history for a partner or a CRM lead (who called, when, how long, answered?).
- Get a recording / voicemail transcription for a call.
- Place / trigger an outbound call (Ringover callback API, or the browser softphone action).
- Log or reconcile a call that a webhook or REST sync should have created.
- Send an SMS tied to a call on the Twilio path, or read logged inbound/outbound SMS.
- Diagnose "no calls are logging" — usually unconfigured creds, wrong provider, or the
everjust.phone.calllead_idbug (see Pitfalls).
Do NOT use this skill for, and stop if the task is really:
- Texting as a product / mass-SMS / template SMS / gateway routing — that is the
everjust_sms_gateway(sms.sms,res.company.sms_provider) stack. Use [[everjust-sms]]. Theeverjust.phone.smsmodel here is only Twilio-call-adjacent SMS logging, not that. - CRM pipeline work (create/qualify leads, stages, activities) — that is [[everjust-crm-sales]].
This skill only reads
crm.leadto attach call logs and creates a missed-call activity. - Native mail / webmail — [[everjust-mail-ops]].
- Provisioning a Twilio/Ringover account, DNS, or SIP trunk — platform-ops, out of scope.
Install & config state (READ THIS — it is not uniform)
Ground-truthed by introspecting the live prod DBs (deployment-odoo-1, 2026-07). The prompt's
premise that "it isn't installed on any tenant" is stale — it is now installed on several,
but mostly installed-yet-unconfigured (dormant). Confirm per tenant; never assume.
| Tenant | voip_oca | everjust_ringover | everjust_phone | Provider in effect |
|---|---|---|---|---|
headsup | installed | installed | uninstalled | Ringover |
weldon | installed | uninstalled | installed (unconfigured) | Twilio (dormant) |
burekraft-llc | installed | uninstalled | installed (unconfigured) | Twilio (dormant) |
riftline-labs | installed | uninstalled | installed (unconfigured) | Twilio (dormant) |
trust-works-company | installed | uninstalled | installed (unconfigured) | Twilio (dormant) |
connectdomain | installed | uninstalled | uninstalled | voip_oca shell only |
control | (module rows absent) | — | — | none |
tcstartupweek | installed | uninstalled | uninstalled | voip_oca shell only |
- On the Twilio tenants, every
everjust_phone.*config param is empty (account_sid,auth_token,api_key,api_secret,twiml_app_sid,phone_numberallFalse) andeverjust.phone.call/.smshave 0 rows — the app is installed but has never been wired or exercised. Any token/SMS/call call will return{"error": "Twilio not configured"}. - On
headsup, Ringover REST creds (everjust.ringover_api_url/api_key) gate the sync — an emptyeverjust.ringover_api_keymeanssync_recent/cron_sync_allno-op silently.
Key models (real _names and fields, verified live)
voip_oca (base engine — present on all tenants)
| Model | Role | Notable fields |
|---|---|---|
voip.pbx | PBX/softphone config. voip_oca seeds a Default PBX (domain=pbx.everjust.app, ws_server=wss://pbx.everjust.app:7443, mode=test). | name (req), domain, ws_server, mode (test|prod) |
voip.call | A softphone session row (front-end lifecycle: calling→ongoing→terminated). Not the CDR of record on the Ringover path. | phone_number (req), type_call (incoming|outgoing), state (aborted|calling|missed|ongoing|rejected|terminated), partner_id→res.partner, user_id→res.users, pbx_id→voip.pbx, start_date, end_date, activity_name |
res.users (ext) | Per-user SIP creds for the engine. | voip_pbx_id→voip.pbx, voip_username, voip_password (self-read/write-able) |
mail.activity (ext) | Adds phone-call context to activities. | main_partner_id→res.partner, main_partner; get_call_activities() returns overdue category='phonecall' activities |
everjust_ringover (Ringover path — installed on headsup)
| Model | Role | Notable fields |
|---|---|---|
ringover.call | Ringover CDR of record — one row per completed call, synced from Ringover REST/webhook, deduped by cdr_id. This is the call-history table on Ringover tenants. | cdr_id (dedupe key), call_id, direction (in|out), contact_number, from_number, to_number, start_time, end_time, duration (sec), is_answered (bool), state, hangup_by, recording_url, voicemail_url, ringover_user_id, ringover_user_name (agent), partner_id→res.partner, lead_id→crm.lead, user_id→res.users |
ringover.call also carries the operational methods: _sync_from_api_data, sync_recent,
cron_sync_all (10-min cron auto-created by _post_init_hook), initiate_call,
find_record_for_number (screen-pop resolver), _ringover_api_get.
everjust_phone (Twilio path — installed but unconfigured on 4 tenants)
| Model | Role | Notable fields |
|---|---|---|
everjust.phone.call | Twilio call log, keyed by call_sid, upserted from webhooks. | call_sid, direction (inbound|outbound), from_number, to_number, status (queued/ringing/in-progress/completed/busy/no-answer/canceled/failed), start_time, end_time, duration, recording_url, recording_sid, transcription, partner_id→res.partner, user_id→res.users. NO lead_id field — see Pitfalls. |
everjust.phone.sms | Twilio SMS log (call-adjacent), keyed by message_sid. | message_sid, direction (inbound|outbound), from_number, to_number, body, status, partner_id→res.partner, user_id→res.users |
Methods: everjust.phone.call.get_twilio_token(), log_call_from_webhook(data);
everjust.phone.sms.send_sms(to_number, body), log_sms_from_webhook(data). Config lives in
ir.config_parameter keys everjust_phone.{account_sid,auth_token,api_key,api_secret,twiml_app_sid,phone_number}.
Recipes
Route each through the tenant's Odoo MCP (open the session per [[everjust-agent-mcp]]).
0. FIRST: which provider is this tenant on, and is it configured?
Never operate before you know the path. Check module install state, then creds.
# Which of the two providers is installed?
env['ir.module.module'].search_read(
[('name', 'in', ['everjust_ringover', 'everjust_phone', 'voip_oca'])],
['name', 'state'])
# -> everjust_ringover installed => use ringover.call (Recipes 1–3)
# -> everjust_phone installed => use everjust.phone.* (Recipes 4–5); CHECK creds:
ICP = env['ir.config_parameter'].sudo()
[bool(ICP.get_param('everjust_phone.%s' % k)) for k in
('account_sid','auth_token','api_key','api_secret','twiml_app_sid','phone_number')]
# all False => Twilio not wired; get_twilio_token/send_sms return {"error":"Twilio not configured"}
bool(ICP.get_param('everjust.ringover_api_key')) # Ringover REST sync gate
If only voip_oca is installed, there is no call-history table beyond ad-hoc voip.call
session rows — say so; don't invent a provider. Never print the cred values (they are
secrets — [[everjust-platform]]); check presence with bool(...).
1. (Ringover) Read a partner's / lead's call history
p = env['res.partner'].search([('phone', 'like', '5551234')], limit=1)
env['ringover.call'].search_read(
[('partner_id', '=', p.id)],
['direction', 'contact_number', 'start_time', 'duration', 'is_answered',
'state', 'recording_url', 'ringover_user_name', 'lead_id'],
order='start_time desc', limit=50)
# Or resolve a raw number to the best Odoo record (lead preferred, else contact):
env['ringover.call'].find_record_for_number('+16125551234') # -> {'model','res_id'} or {}
duration is seconds; is_answered=False on an inbound call is a missed call (the sync
auto-creates a "call back" mail.activity on the lead/partner — see Pitfalls #4).
2. (Ringover) Force a REST sync (pull recent calls now)
The webhook is only a nudge; the authoritative load is the REST pull, deduped by cdr_id.
env['ringover.call'].sync_recent() # pulls the last ~10 calls, upserts by cdr_id
# broader catch-up (what the 10-min cron runs):
env['ringover.call'].cron_sync_all() # pulls last ~50
Both are safe to call repeatedly (idempotent on cdr_id). They no-op if
everjust.ringover_api_url/everjust.ringover_api_key are unset — verify creds first (Recipe 0).
3. (Ringover) Trigger an outbound call (server-side callback)
res = env['ringover.call'].initiate_call('', '+1 (612) 555-1234') # first arg unused
# {'success': True} -> Ringover rings the agent's device(s), then dials the recipient
# {'error': '...'} -> not configured, no from_number, or bad destination
Requires everjust.ringover_api_key and everjust.ringover_from_number in System
Parameters. Ringover's /callback API needs integer E.164 — the method strips non-digits,
prefixes 1 for bare 10-digit US/CA, and casts to int; passing a +/string yourself to the
raw API returns HTTP 400 (see Pitfalls #3). For the browser softphone instead, the UI fires
the ringover_dial client action (partner.action_ringover_call() /
lead.action_ringover_call()) which drives the Ringover Web SDK — not something you invoke
headless over MCP.
4. (Twilio) Read / place a call, get a recording or transcription
# History (keyed by call_sid; transcription is voicemail STT):
env['everjust.phone.call'].search_read(
[('partner_id', '=', p.id)],
['direction','from_number','to_number','status','duration',
'recording_url','transcription','start_time'],
order='start_time desc', limit=50)
# Mint a browser Voice-SDK token (fails if Twilio unconfigured):
env['everjust.phone.call'].get_twilio_token() # -> {'token','identity'} or {'error':...}
There is no headless "dial" method on the Twilio path — an outbound call is initiated by
the browser Voice SDK, which hits the /phone/twiml/outbound webhook that returns a <Dial>.
partner.action_phone_call() just opens the softphone client action pre-filled. Do not
hand-write everjust.phone.call rows to fake a call; let log_call_from_webhook own that
(and note the lead_id bug in Pitfalls #2 before relying on it).
5. (Twilio) Send an SMS / read logged SMS
res = env['everjust.phone.sms'].send_sms('+16125551234', 'Following up on our call.')
# {'success': True, 'sid': '...'} or {'error': 'Twilio not configured' / <exception>}
env['everjust.phone.sms'].search_read(
[('partner_id', '=', p.id)],
['direction','from_number','to_number','body','status','create_date'],
order='create_date desc', limit=50)
This sends via the Twilio REST Client using everjust_phone.account_sid + auth_token +
phone_number. This is not the tenant SMS product. If the task is "text a customer" as a
first-class action (templates, mass-SMS, delivery gating, gateway routing), use [[everjust-sms]]
(sms.sms / res.company.sms_provider), not this call-adjacent logger.
Pitfalls (everjust-specific)
-
Confirm the provider before every operation — they are alternatives, not layers. Ringover tenants have
ringover.call; Twilio tenants haveeverjust.phone.*; a barevoip_ocatenant has neither history table. Reaching for the wrong model returns empty or raisesInvalid field on model. Run Recipe 0 first. -
everjust.phone.callhas NOlead_idfield, butlog_call_from_webhookwrites one. The webhook handler buildsvalswith"lead_id": lead.id if lead else Falseand, whenever a call matches a partner (so a lead lookup runs), the subsequentcreate/writeraisesValueError: Invalid field 'lead_id' on model 'everjust.phone.call'. Result: on the Twilio path, CRM-linked call logging is broken — status-callback/recording webhooks 500, and completed calls for known contacts may not log. This is a live bug (verified onweldon). Do not assume a Twilio call was logged just because it happened; check for the row. Fixing it means adding alead_id = fields.Many2one('crm.lead')field (likeringover.callhas) or dropping the key fromvals— a code change toeverjust_phone/models/phone_call.py, not an ORM write. -
Ringover wants integer E.164; strings 400. The REST
/callbackand Ringover's SMS webhook usefrom_number/to_numberas int64, not strings.initiate_callalready normalizes and casts, so call it; if you ever hit the Ringover API directly, send digits as integers (US/CA bare 10-digit → prefix1), or you get HTTP 400. -
Missed inbound Ringover calls auto-create a
mail.activity("call back …"). In_sync_from_api_data, a call withdirection='in'andis_answered=Falsespawns a To-Do activity on the linked lead (else partner), assigned to the mapped Odoo user (matched by Ringover agent email →res.users.login) or the current user. Re-runningsync_recentis deduped bycdr_idso it won't double-file the call, but be aware activities are a side effect of the sync. This is why this skill touchescrm.leadat all — pipeline work itself is [[everjust-crm-sales]]. -
SECURITY — telephony webhooks are
auth="none"but now SIGNATURE-VERIFIED and FAIL CLOSED. (Updated 2026-07 — ww.everjust.app#138 closed what used to be an unauthenticated, fail-open surface. If you are reading an older copy of this skill, that guidance is obsolete.)- Twilio (
everjust_phone/controllers/twilio_webhooks.py—/phone/twiml/outbound|inbound| voicemail,/phone/webhook/status|recording|transcription|sms): every route now validatesX-Twilio-SignatureviaRequestValidatorand returns 403 on an unsigned/bad-signature POST (_reject_unsigned). Forged call/SMS/recording events are no longer possible. - Ringover (
/ringover/webhook) and the SMS gateway (/sms/incoming) verify a JWT or HMAC signature and now fail CLOSED — with no key configured they REJECT rather than accept (previously_verifyreturnedTrueand accepted anything).
Operational consequence — check this first when inbound "stops working": because these now fail closed, a tenant whose signing keys were never set will silently drop 100% of inbound SMS/call events. Symptom is "no new records, no errors in the UI". Set the per-tenant keys (
everjust.sms_webhook_key; the Ringover per-event keys) in Settings → Technical → System Parameters — note the Ringover settings page only exposes the legacy singleringover_webhook_secret, not the per-event keys the verifier actually reads.Residual caution: unverified Ringover call-sync events still trigger a debounced REST resync and answer 200 (rejections are log-only), and the JWT branch does not bind a claim to the body, so a captured signature authenticates an arbitrary body until key rotation. Still prefer corroboration before treating webhook-sourced rows as authoritative.
- Twilio (
-
voip.callis a session row, not a CDR. On Ringover tenants the call history of record isringover.call(populated by REST sync), notvoip.call.voip.callreflects the front-end softphone lifecycle and may be sparse or absent for server-synced calls. Queryringover.callfor history; usevoip.callonly for live-session/UX state. -
Installed ≠ operational. Four tenants have
everjust_phoneinstalled with zero config and zero rows — token minting and SMS/REST all short-circuit to{"error": "Twilio not configured"}. Likewise Ringover sync no-ops without an API key. "The app is installed" is not "the app works" — verify creds (Recipe 0) before promising a send or a sync. -
Everything is per-tenant DB /
company_id. Provider choice, creds, and call rows are scoped to one tenant. When multi-tenant, confirm you're on the right DB before searching (see [[everjust-agent-mcp]] / [[everjust-platform]]).
See also
- [[everjust-agent-mcp]] — connect to the tenant MCP; the
search/get/create/update/call/describe_modeltoolset every recipe uses. - [[everjust-platform]] — platform invariants (one-DB-per-tenant, sudo/ACL, secrets, /odoo debrand).
- [[everjust-sms]] — the tenant SMS product (
sms.sms, provider-swapped gateway). Use this, noteverjust.phone.sms, for texting as a first-class action. - [[everjust-crm-sales]] — CRM pipeline; this skill only reads
crm.leadto attach call logs and files a missed-call activity. - [[everjust-mail-ops]] — native mail / webmail stack (sibling; also provider-gated).
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |