List tracking numbers
List tracking numbers with their label, attribution (source, medium, campaign), pool, and updated_at. SMS bodies are never returned.
Argumentos
Esta herramienta no recibe argumentos.
List calls
List the latest 50 calls with their outcome tag, without caller phone numbers. For a recording, call roofkit.communications.recordings.playback_link.get with the call id.
Argumentos
Esta herramienta no recibe argumentos.
Get JobNimbus status
Deprecated: use roofkit.integrations.status with provider jobnimbus. This alias stays for one release. Read JobNimbus connection status. Do not send API keys in the tool body.
Argumentos
Esta herramienta no recibe argumentos.
Get connector status
Read the status of the native integrations: status, connected, last health check, last successful sync, the last sync run, and the last error with a safe error type. Send provider for one, or omit it for all. It never returns credentials. Connect and disconnect stay in Settings: use settings_handoff_url.
Argumentos
string
jobnimbus, meta_ads, google_ads, microsoft_ads, or google_analytics. Valores permitidos:
jobnimbus, meta_ads, google_ads, microsoft_ads, google_analytics.List connector sync runs
List the recent sync runs of one integration, newest first, with status, counts, and the error type. limit is 1 to 50, default 20. A status filter reads the newest 200 runs. For google_analytics each run is one conversion event delivery.
Argumentos
string
requerido
jobnimbus, meta_ads, google_ads, microsoft_ads, or google_analytics. Valores permitidos:
jobnimbus, meta_ads, google_ads, microsoft_ads, google_analytics.string
Valores permitidos:
queued, running, succeeded, failed, skipped.integer
Mínimo 1. Máximo 50.
Refresh connector health
Check the saved connection with the provider now, as the Refresh button in Settings does. It calls the provider API, records a connection check, and updates the connection status. It returns the new status. A connector with no saved credential answers refreshed: false.
Argumentos
string
requerido
meta_ads, google_ads, microsoft_ads, or google_analytics. Valores permitidos:
meta_ads, google_ads, microsoft_ads, google_analytics.Retry connector sync run
Retry a failed or skipped sync run, as the Retry button in Settings does. For meta_ads, google_ads, and microsoft_ads it does not replay that one run: it queues a full catalog and insights sync of the connection. For google_analytics it queues that one conversion event again, which sends it to Google Analytics. Requires an idempotency key.
Argumentos
string
requerido
meta_ads, google_ads, microsoft_ads, or google_analytics. Valores permitidos:
meta_ads, google_ads, microsoft_ads, google_analytics.string
requerido
string
requerido
A run id from roofkit.integrations.sync_runs.list.
List DNI pools
List the active and paused DNI pools, highest priority first: name, type, status, match rules, fallback, exhaustion mode, numbers, and updated_at. Send updated_at as expected_updated_at to roofkit.communications.pools.save. Forwarding and whisper settings stay in the app.
Argumentos
Esta herramienta no recibe argumentos.
Update tracking number
Update the attribution (source, medium, campaign) or the label of one tracking number. Only the fields sent change, and calls and texts that arrive later carry them. A label alone is the legacy “source / campaign” form. Send expected_updated_at from roofkit.communications.numbers.list to refuse the write over a newer change. The forwarding destination, purchase, and release stay in the app.
Argumentos
string
requerido
A number id from roofkit.communications.numbers.list.
string
Where callers see the number, for example google. Como máximo 100 caracteres.
string
For example cpc or organic. An empty string clears it. Como máximo 100 caracteres.
string
An empty string clears it. Como máximo 100 caracteres.
string
Legacy “source / campaign” label. Prefer source and campaign. Como máximo 200 caracteres.
string
Set number DNI pool
Move one tracking number into an active DNI pool, or out of every pool with pool_id null. A number sits in one pool at most. Website visitors get numbers from the new pools at once. The Phone System plan caps the pool size.
Argumentos
string
requerido
A number id from roofkit.communications.numbers.list.
string | null
requerido
A pool id, or null to leave every pool.
Save DNI pool
Create a DNI pool, or change the rules of one pool: name, type, status, match rules, priority, fallback, exhaustion mode, and numbers. A rule the call leaves out keeps its value. Website visitors get numbers by the new rules at once. Overlapping rules answer CONFLICT. Forwarding and whisper settings stay in the app.
Argumentos
string
The pool to change. Leave it out to create a pool.
string
Como máximo 120 caracteres.
string
Valores permitidos:
static, dni_pool, landing, source_campaign, fallback.string
Valores permitidos:
active, paused.number
string
Where callers see the number, for example google. Como máximo 100 caracteres.
string
For example cpc or organic. An empty string clears it. Como máximo 100 caracteres.
string
An empty string clears it. Como máximo 100 caracteres.
string
Como máximo 100 caracteres.
string
Como máximo 200 caracteres.
boolean
string
string
string
Valores permitidos:
fallback_pool, static_default, keep_original, block.string[]
Every number of the pool.
number
Mínimo 1. Máximo 1440.
string
updated_at of the pool from roofkit.communications.pools.list.
Set call outcome tag
Set “What happened” on one call: booked, quoted, not_a_fit, or spam, or null to clear it. The tag shows at once in the call log and the call reports. Send expected_outcome_tag from roofkit.communications.calls.list to refuse the write with CONFLICT when someone changed the tag first.
Argumentos
string
requerido
A call id from roofkit.communications.calls.list.
string | null
requerido
Valores permitidos:
booked, quoted, not_a_fit, spam, null.string | null
The tag as you read it. Null means no tag. Valores permitidos:
booked, quoted, not_a_fit, spam, null.Get call recording link
Return a playback link for the recording of one call. The link works for 15 minutes without sign-in, so share it only with people who may hear the call. The request and every play are logged in the recording access log of the workspace. Needs communications.manage too.
Argumentos
string
A call id from roofkit.communications.calls.list.
string