get_campaign

Read the campaign

Lecture · mcpIdempotent

Lit la campagne : son état, ses dates et les compteurs du fournisseur — envoyés, réponses, ouvertures, rebonds, et quand ils ont été mesurés — et, une fois l'envoi installé, les quatre chiffres de lancement que l'utilisateur confirme avant de lancer.

Description lue par le modèleEnvoyée telle quelle dans tools/list, en anglais.

Read the workspace's campaign: its state, its dates and the provider's counters (sent, replies, opens, bounces, when they were measured), and once the sending setup exists, the four launch figures the user confirms before a launch — contacts ready, sending mailboxes, emails on the first day, weekly sending window.

Exemple

L'utilisateur dit

Comment se passe ma campagne ?

tools/call · Arguments envoyés par l'assistant

{
  "name": "get_campaign",
  "arguments": {}
}

Arguments

Cet outil ne prend aucun argument. {}

Schéma d'entrée

{
  "type": "object",
  "properties": {}
}

Résultat

Sorte de résultatcampaign

kind"campaign"

outcomestring | null

What the call that rendered it did, in a sentence. Null for a plain read.

campaignobjet | null

The live campaign, or the last one when none is live. Null before any.

• id string — The campaign id launch, stop and resume take. Never invent one.
• name string
• state string
• stateLabel string
• live boolean
• startsOn string | null
• endsOn string | null
• stats objet | null — The last counters read from the provider. Null until a first reading.

launchRecapobjet | null

What the user confirms before a launch. Null before the sending setup step.

• complete boolean — False while one of the four figures is missing.
• contacts integer — Leads ready to be pushed into the campaign.
• sendingMailboxes string[]
• firstDayEmails integer | null
• window objet | null — The weekly sending window, in the workspace's timezone.

appUrlstring

Schéma de sortie

{
  "type": "object",
  "properties": {
    "kind": {
      "type": "string",
      "const": "campaign"
    },
    "outcome": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "What the call that rendered it did, in a sentence. Null for a plain read."
    },
    "campaign": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "id": {
              "type": "string",
              "description": "The campaign id launch, stop and resume take. Never invent one."
            },
            "name": {
              "type": "string"
            },
            "state": {
              "type": "string"
            },
            "stateLabel": {
              "type": "string"
            },
            "live": {
              "type": "boolean"
            },
            "startsOn": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ]
            },
            "endsOn": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ]
            },
            "stats": {
              "anyOf": [
                {
                  "type": "object",
                  "properties": {
                    "sent": {
                      "type": "integer"
                    },
                    "replies": {
                      "type": "integer"
                    },
                    "opens": {
                      "type": "integer"
                    },
                    "bounces": {
                      "type": "integer"
                    },
                    "measuredAt": {
                      "type": "string",
                      "description": "When the provider's counters were last read."
                    }
                  },
                  "required": ["sent", "replies", "opens", "bounces", "measuredAt"],
                  "additionalProperties": false
                },
                {
                  "type": "null"
                }
              ],
              "description": "The last counters read from the provider. Null until a first reading."
            }
          },
          "required": [
            "id",
            "name",
            "state",
            "stateLabel",
            "live",
            "startsOn",
            "endsOn",
            "stats"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ],
      "description": "The live campaign, or the last one when none is live. Null before any."
    },
    "launchRecap": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "complete": {
              "type": "boolean",
              "description": "False while one of the four figures is missing."
            },
            "contacts": {
              "type": "integer",
              "description": "Leads ready to be pushed into the campaign."
            },
            "sendingMailboxes": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "firstDayEmails": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ]
            },
            "window": {
              "anyOf": [
                {
                  "type": "object",
                  "properties": {
                    "days": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "from": {
                      "type": "string"
                    },
                    "to": {
                      "type": "string"
                    }
                  },
                  "required": ["days", "from", "to"],
                  "additionalProperties": false
                },
                {
                  "type": "null"
                }
              ],
              "description": "The weekly sending window, in the workspace's timezone."
            }
          },
          "required": [
            "complete",
            "contacts",
            "sendingMailboxes",
            "firstDayEmails",
            "window"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ],
      "description": "What the user confirms before a launch. Null before the sending setup step."
    },
    "appUrl": {
      "type": "string"
    }
  },
  "required": ["kind", "outcome", "campaign", "launchRecap", "appUrl"],
  "additionalProperties": false
}

Bon à savoir

• Les quatre chiffres de lancement : contacts prêts, boîtes d'envoi, emails le premier jour, fenêtre d'envoi hebdomadaire.
• Son id de campagne est celui que prennent launch_campaign, stop_campaign et resume_campaign.

Outils liés

launch_campaignLaunch the campaign

list_repliesList prospect replies

stage_campaignPrepare the campaign