Contents

# frozen_string_literal: true

module ActiveCampaign
  #
  # @example Contacts
  #
  #   ActiveCampaign::Contact.find(1)
  #   ActiveCampaign::Contact.find_by email: "[e-mail]"
  #   ActiveCampaign::Contact.find(1).destroy
  #   ActiveCampaign::Contact.find(1).contact_tags
  #
  class Contact < Model
    define_attributes :email,
                      :phone,
                      :firstName,
                      :lastName

    # @example Find contact's tags.
    #
    #   ActiveCampaign::Contact.find(1).contact_tags
    #   ActiveCampaign::Contact.find(1).contact_tags.last.destroy
    #
    def contact_tags
      ContactTag.get "#{self.class.endpoint}/#{id}/contactTags"
    end

    # @example Add a tag to a contact.
    #
    #   ActiveCampaign::Contact.find(1).add_tag "tag-name"
    #
    # Don't create the tag if it doesn't exist.
    #
    #   ActiveCampaign::Contact.find(1).add_tag "tag-name", create_if_not_found: false
    #
    def add_tag(tag, create_if_not_found: true)
      tag_id = Tag.find_by(tag: tag)&.id

      tag_id = ActiveCampaign::Tag.create(tag: tag)&.id if !tag_id && create_if_not_found

      return false unless tag_id

      ActiveCampaign::ContactTag.create contact: id, tag: tag_id
    end

    # @example Remove a tag from a contact.
    #
    #   ActiveCampaign::Contact.find(1).remove_tag "tag-name"
    #
    def remove_tag(tag)
      tag_id = Tag.find_by(tag: tag)&.id

      return false unless tag_id

      contact_tag = contact_tags.filter_map { |ct| ct if ct.tag == tag_id }.last

      contact_tag&.destroy
    end
  end
end

Version data entries

2 entries across 2 versions & 1 rubygems

Version	Path
ractive_campaign-0.1.6	lib/active_campaign/models/contact.rb
ractive_campaign-0.1.5	lib/active_campaign/models/contact.rb