Embudos


Dentro de la estrategia de Marketing de Contenido existen etapas importantes, al final no todos sus contactos tienen el mismo interés o están en la misma fase de relación con su producto y / o empresa.

Estas etapas y la transición entre ellos forman lo que llamamos embudo de ventas, que también puede llamarse embudo del Marketing, en el que el volumen de personas que llegan en la cima (visitantes) va disminuyendo a lo largo del proceso de venta hasta convertirse en clientes , en el fondo del embudo.

La API de embudos le permite manipular las etapas de embudo de sus contactos, actualmente se pueden clasificar como: Lead, Lead Qualified y Cliente.

Métodos disponibles

Returns a list of Funnels associated to the given contact.
Request Parameter
uuid String The unique uuid associated to RD Station Contact.
funnel_name String The contact funnel name. For now, the only accepted option is: "default".

Response Body
Field Type Description
lifecycle_stage String The stage in the funnel which the contact belongs to. Valid options: 'Lead', 'Qualified Lead' and 'Client'.
opportunity Boolean It indicates whether the contact is an opportunity or not in the funnel.
contact_owner_email String The email of the user responsible for the contact.
fit Integer The contact fit score in the current funnel.
interest Integer The contact interest score in the current funnel.

Example:

Code: 200

{
  "lifecycle_stage": "Client",
  "opportunity": true,
  "contact_owner_email": "email@example.org",
  "fit": 60,
  "interest": 100
}
Returns a list of Funnels associated to the given contact.
Request Parameter
email String The email associated to RD Station Contact.
funnel_name String The contact funnel name. For now, the only accepted option is: "default".

Response Body
Field Type Description
lifecycle_stage String The stage in the funnel which the contact belongs to. Valid options: 'Lead', 'Qualified Lead' and 'Client'.
opportunity Boolean It indicates whether the contact is an opportunity or not in the funnel.
contact_owner_email String The email of the user responsible for the contact.
fit Integer The contact fit score in the current funnel.
interest Integer The contact interest score in the current funnel.

Example:

Code: 200

{
  "lifecycle_stage": "Client",
  "opportunity": true,
  "contact_owner_email": "email@example.org",
  "fit": 60,
  "interest": 100
}
Updates the funnel information about the current contact.
Request body parameters
Field Type Description
lifecycle_stage String The stage in the funnel which the contact belongs to. Valid options: 'Lead', 'Qualified Lead' and 'Client'.
opportunity Boolean It indicates whether the contact is an opportunity or not in the funnel.
contact_owner_email String The email of the user responsible for the contact. Can be defined as null for disassociate the current owner.

Validations
Attributes validations:
Field Error type Rule
lifecycle_stage CANNOT_BE_NULL lifecycle_stage cannot be null
lifecycle_stage MUST_BE_STRING lifecycle_stage must be string
lifecycle_stage MUST_BE_LESS_THAN_OR_EQUAL lifecycle_stage must less than or equal to 50
lifecycle_stage MUST_BE_VALID_OPTION invalid options for lifecycle_stage, the valid options are: 'Lead', 'Qualified Lead', 'Client'
opportunity CANNOT_BE_NULL opportunity cannot be null
opportunity MUST_BE_BOOLEAN opportunity must be boolean
contact_owner_email MUST_BE_STRING contact_owner_email must be string
contact_owner_email MUST_BE_LESS_THAN_OR_EQUAL contact_owner_email must less than or equal to 100
contact_owner_email INVALID_EMAIL_FORMAT contact_owner_email has an invalid format
contact_owner_email INVALID_USER The user {user} was not found in your account.

Request body example
{
  "lifecycle_stage": "Client",
  "opportunity": true,
  "contact_owner_email": "email@example.org"
}
Response examples:

Success | Code: 200


{
  "lifecycle_stage": "Client",
  "opportunity": true,
  "contact_owner_email": "email@example.org",
  "fit": 60,
  "interest": 100
}
        


Error | Code: 400

Attributes errors
{
  "errors": {
    "lifecycle_stage": [
      {
        "error_type": "CANNOT_BE_NULL",
        "error_message": "lifecycle_stage cannot be null"
      },
      {
        "error_type": "MUST_BE_STRING",
        "error_message": "lifecycle_stage must be string"
      },
      {
        "error_type": "MUST_BE_LESS_THAN_OR_EQUAL",
        "error_message": "lifecycle_stage must less than or equal to 50"
      },
      {
        "error_type": "MUST_BE_VALID_OPTION",
        "error_message": "invalid options for lifecycle_stage, the valid options are: 'Lead', 'Qualified Lead' and 'Client'"
      }
    ],
    "opportunity": [
      {
        "error_type": "CANNOT_BE_NULL",
        "error_message": "opportunity cannot be null"
      },
      {
        "error_type": "MUST_BE_BOOLEAN",
        "error_message": "opportunity must be boolean"
      }
    ],
    "contact_owner_email": [
      {
        "error_type": "MUST_BE_STRING",
        "error_message": "url must be string"
      },
      {
        "error_type": "MUST_BE_LESS_THAN_OR_EQUAL",
        "error_message": "url must less than or equal to 100"
      },
      {
        "error_type": "INVALID_EMAIL_FORMAT",
        "error_message": "contact_owner_email has an invalid format"
      },
      {
        "error_type": "INVALID_USER",
        "error_message": "The user {user} was not found in your account."
      }
    ]
  }
}